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

# MCP

> Connect Claude, ChatGPT, and other AI tools to Charlie through the telli MCP server.

The telli MCP server lets AI tools like Claude, ChatGPT, and Codex talk to [Charlie](../cookbooks/charlie/overview), telli's AI assistant, over the [Model Context Protocol](https://modelcontextprotocol.io). Once connected, you can ask questions and trigger work in telli from the tools you already use.

<Note>
  This is a **personal** connection. It authorizes the AI tool as you, works across every telli account you can access, and applies your role in each account. Teammates manage their own connections.
</Note>

## Before you start

You need:

* Access to the telli app.
* An AI tool that supports remote MCP servers over HTTP.

## Connect your AI tool

Add the telli MCP server to your tool, then authorize it when the tool sends you to telli. The server URL is:

```bash theme={null}
https://mcp.telli.com/mcp
```

<Tabs>
  <Tab title="Claude">
    Open Claude's connector settings, add a custom connector, and paste the server URL.
  </Tab>

  <Tab title="ChatGPT">
    Enable developer mode under **Apps & Connectors**, then create a connector with the server URL.
  </Tab>

  <Tab title="Cursor">
    Use the **Add to Cursor** button on the MCP integration page in telli. It opens Cursor and asks to add the telli MCP server.
  </Tab>

  <Tab title="Codex CLI">
    Run the command below, then authenticate with `codex mcp login telli`.

    ```bash theme={null}
    codex mcp add telli --url https://mcp.telli.com/mcp
    ```
  </Tab>

  <Tab title="Claude Code">
    Run this command in your terminal:

    ```bash theme={null}
    claude mcp add --transport http telli https://mcp.telli.com/mcp
    ```
  </Tab>
</Tabs>

The MCP integration page in telli lists these tools with copy-ready links and commands, so you don't have to type the server URL by hand.

## How the connection works

You add the telli MCP server to your AI tool. The tool then sends you to telli to authorize the connection via OAuth, and receives its own access credentials once you approve.

Each authorized tool shows up as a connection on the MCP integration page, where you can remove it at any time. Removing a connection stops the tool's access, though it may keep working for a few minutes until its current token expires.

## Available tools

Once connected, your AI tool can use these tools:

| Tool                         | What it does                                                                       |
| :--------------------------- | :--------------------------------------------------------------------------------- |
| `ask_charlie`                | Send a message to Charlie. Starts a new conversation or continues an existing one. |
| `get_charlie_conversation`   | Get the latest response from a conversation while Charlie is still working.        |
| `list_charlie_conversations` | List your recent Charlie conversations across your accounts.                       |
| `list_telli_accounts`        | List the telli accounts you can access, with your role in each.                    |

## Manage your connections

From the MCP integration page in telli, you can see every AI tool you have authorized, when it was authorized, and remove any connection you no longer need. Removing a connection requires the tool to be authorized again before it can reconnect.