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

# Connect your AI app

> Step-by-step setup for Claude, ChatGPT, Claude Code, Cursor, Codex and other MCP apps, plus what you see on the Topcalls consent screen.

## What is the Topcalls MCP server address?

```text theme={null}
https://www.topcalls.ai/api/mcp
```

Every AI app connects to this one address. There's no API key or token to copy: your app sends you to Topcalls to sign in instead.

You can also copy your link from **CLI & MCP** in the Setup menu in Topcalls.

The last step of every connection is the same. Sign in to Topcalls, choose the account to connect, turn on **Read only** if the app should only look, and select **Allow access**.

## How do I connect Claude to Topcalls?

**1. Open Connectors**

Open Claude.ai and go to Settings, then Connectors.

**2. Add a custom connector**

Choose Add custom connector and paste `https://www.topcalls.ai/api/mcp`.

**3. Allow access in Topcalls**

Sign in to Topcalls, choose the account to connect, turn on Read only if the app should only look, and select Allow access.

## How do I connect ChatGPT to Topcalls?

**1. Add a custom MCP server**

In ChatGPT, open Plugins in the sidebar and add a custom MCP server.

**2. Fill in the server**

Name it Topcalls, paste `https://www.topcalls.ai/api/mcp` as the Server URL and set Authentication to OAuth. Tick the box that says you understand and want to continue, then create it.

**3. Allow access in Topcalls**

Sign in to Topcalls, choose the account to connect, turn on Read only if the app should only look, and select Allow access.

ChatGPT gets every tool except the two Integrations tools (`list_integration_flows` and `run_integration_flow`).

## How do I connect Claude Code to Topcalls?

```bash theme={null}
claude mcp add --transport http topcalls https://www.topcalls.ai/api/mcp
```

**1. Add the server**

Run the command above in your terminal.

**2. Sign in from Claude Code**

In Claude Code, run `/mcp`, choose topcalls and sign in.

**3. Allow access in Topcalls**

Sign in to Topcalls, choose the account to connect, turn on Read only if the app should only look, and select Allow access.

## How do I connect Cursor to Topcalls?

**1. Open Tools & MCP**

Open Cursor Settings and go to Tools & MCP.

**2. Add the server**

Add a new MCP server named topcalls with `https://www.topcalls.ai/api/mcp` as its URL, then select Connect next to it.

**3. Allow access in Topcalls**

Sign in to Topcalls, choose the account to connect, turn on Read only if the app should only look, and select Allow access.

## How do I connect Codex to Topcalls?

```bash theme={null}
codex mcp add topcalls --url https://www.topcalls.ai/api/mcp
codex mcp login topcalls
```

**1. Add the server**

Run the first command above in your terminal.

**2. Sign in**

Run the second command. Codex opens Topcalls in your browser.

**3. Allow access in Topcalls**

Sign in to Topcalls, choose the account to connect, turn on Read only if the app should only look, and select Allow access.

Prefer one command for several apps? [`topcalls agent setup`](https://docs.topcalls.ai/cli/install#how-do-i-add-topcalls-to-my-ai-coding-apps) adds the server to Claude Code, Cursor, Codex and VS Code for you.

## Can I connect another MCP app?

Yes, if it can add a remote MCP server and sign in with OAuth. Add a server named topcalls with `https://www.topcalls.ai/api/mcp` as its address, and the app sends you to Topcalls to allow access.

Topcalls sends the sign-in result only to addresses it knows: Claude, ChatGPT, Cursor, VS Code and apps running on your own computer. A web app outside that list gets the message "This app cannot be connected", and nothing is shared.

## What do you see when you connect?

* The app's name and the address it sends you back to. An app that returns to a known address, such as claude.ai or chatgpt.com, shows **Address checked** next to that address. Any other app is marked **Unverified**. Any app can give itself any name, so continue only if you started the connection yourself.
* The Topcalls account to connect. A connection works on that one account only.
* A **Read only** switch. When it's on, the app can look at your data but can't change anything.
* **Allow access** and **Deny**. Nothing is shared until you select **Allow access**.

### Why does the Topcalls consent page sometimes say Unverified?

Apps that send you back to a known address, such as claude.ai or chatgpt.com, show **Address checked** instead. Any other app is marked **Unverified**: any app can give itself any name, including the name of a well-known one, so Topcalls can't confirm who is asking.

**Address checked** only shows where you go back to. Anyone with an account at that address can start a connection, and the app picks its own name. Either way, check the address the page shows and continue only if you started the connection yourself.

## Do I need an API key to connect Topcalls to Claude?

No. The Topcalls MCP server uses sign-in with your Topcalls login through OAuth. You paste the server address into Claude, sign in on Topcalls and allow access. There's no API key or token to copy or store.

## Can two people connect the same Topcalls account?

Yes. Each member connects their own AI app, and each connection has its own access choice. A member sees and ends their own connections. The account owner sees every connection and can end any of them.


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