> ## Documentation Index
> Fetch the complete documentation index at: https://docs-old.aisync.link/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP

**MCP** connects your AI assistant (**Claude**, **Codex**, or **Grok**) directly to **AI Sync**.

After a one-time setup, you can work with your AI Sync project by giving normal instructions to your agent — create agents, manage numbers, check calls, and more — **without opening or login to your project**.

<img src="https://mintcdn.com/rizler/jxnwTkU-d4s1RIWO/images/mcp/claude.png?fit=max&auto=format&n=jxnwTkU-d4s1RIWO&q=85&s=3ee9498f80929b104f5d919fdb8b8a67" alt="Connect to AI Sync MCP window" className="rounded-lg border shadow-sm" width="1002" height="784" data-path="images/mcp/claude.png" />

<Note>
  **There are two AI Sync connections.** This page sets up the one that reads and
  changes **your account**, which needs your login.

  There is also a read-only connection to **these documentation pages** that needs
  no account at all — useful for new reps and contractors. See
  [Connect your agent to these docs](/agents/docs-mcp). Most teams run both.
</Note>

## 🎯 Why use MCP?

Without MCP, you open the AI Sync Dashboard and click through screens to do work.

With MCP, you stay in your AI client and type what you need. Your agent talks to AI Sync for you.

| Without MCP | With MCP |
| - | - |
| Open the Dashboard | Stay in Claude, Codex, or Grok |
| Click through menus and forms | Give a plain-language command |
| Switch between tools | Keep working in one place |

**Examples of what you can ask after connecting:**

* “List my AI agents”
* “Create a new outbound agent for lead follow-up”
* “Show recent call history”
* “Which phone numbers are available?”

You describe the task. Your agent uses AI Sync through MCP.

## 🧭 One-time setup

Do this once per client. After that, you only give commands.

1. Open **MCP** (Connect to AI Sync MCP).
2. Pick your client: **Claude**, **Codex**, or **Grok**.
3. Click **Copy** and run the command in your terminal.
4. Approve access in your browser when asked.

<Note>
  Setup is only for connecting the client. Day-to-day use is just talking to your agent.
</Note>

## 🟣 Claude

1. Select the **Claude** tab.
2. Run these commands:

```bash theme={null}
claude mcp add --transport http ai-sync https://mcp.aisync.link/mcp-oauth
claude mcp login ai-sync
```

3. The second command opens your browser — log in and approve the connection.

<img src="https://mintcdn.com/rizler/jxnwTkU-d4s1RIWO/images/mcp/claude.png?fit=max&auto=format&n=jxnwTkU-d4s1RIWO&q=85&s=3ee9498f80929b104f5d919fdb8b8a67" alt="Claude MCP setup commands" className="rounded-lg border shadow-sm" width="1002" height="784" data-path="images/mcp/claude.png" />

## 🟦 Codex

1. Select the **Codex** tab.
2. Run this command:

```bash theme={null}
codex mcp add ai-sync --url https://mcp.aisync.link/mcp-oauth
```

3. Codex opens your browser so you can sign in and approve. If it doesn't, run
   `codex mcp login ai-sync`.

<Tip>
  Codex runs on **your own ChatGPT plan**, so building agents, prompts and
  workflows this way costs nothing extra. Keep Codex up to date
  (`npm install -g @openai/codex@latest`). See
  [Use your ChatGPT plan with AI Sync](/agents/use-your-chatgpt-plan).
</Tip>

<img src="https://mintcdn.com/rizler/jxnwTkU-d4s1RIWO/images/mcp/codex.png?fit=max&auto=format&n=jxnwTkU-d4s1RIWO&q=85&s=049640cc382b0ec14a5dfeb47881e4e7" alt="Codex MCP setup command" className="rounded-lg border shadow-sm" width="996" height="708" data-path="images/mcp/codex.png" />

## 🟨 Grok

1. Select the **Grok** tab.
2. Run this command:

```bash theme={null}
grok mcp add --transport http ai-sync https://mcp.aisync.link/mcp-oauth
```

3. Grok opens your browser the first time it needs to authorize.

<img src="https://mintcdn.com/rizler/jxnwTkU-d4s1RIWO/images/mcp/grok.png?fit=max&auto=format&n=jxnwTkU-d4s1RIWO&q=85&s=5db468b3df1057a130c9458081c211e2" alt="Grok MCP setup command" className="rounded-lg border shadow-sm" width="1020" height="716" data-path="images/mcp/grok.png" />

## ✅ How to use it every day

After setup:

1. Open Claude, Codex, or Grok as usual.
2. Ask for what you need in plain language.
3. Your agent uses AI Sync MCP in the background.
4. You do **not** need to open the Dashboard for those tasks.

You only return to **MCP** if you need to reconnect, switch clients, or set up a new machine.

## 🛠️ If something goes wrong

| Problem | What to try |
| - | - |
| Command not found | Install the Claude, Codex, or Grok CLI first |
| Browser does not open | Re-run the connect/login command for your client |
| Agent cannot reach AI Sync | Open **MCP**, copy the command again, and reconnect |
| Wrong client | Use the matching tab before copying the command |

## ➡️ Now that you are connected

<CardGroup cols={2}>
  <Card title="Connect the docs too" icon="book-open-reader" href="/agents/docs-mcp">
    A read-only link to these pages. No login, safe for anyone.
  </Card>

  <Card title="Ask about your numbers" icon="chart-line" href="/agents/asking-about-your-data">
    Questions that work, and how to tell a trustworthy answer from a confident one.
  </Card>

  <Card title="Run your dialer by chat" icon="terminal" href="/agents/running-your-dialer">
    Make real changes safely, and what to confirm before you do.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.