---
id: "api-reference/connect-ai-tool"
type: "doc"
url: "https://affitor.com/docs/api-reference/connect-ai-tool"
kind: "guide"
updated: "2026-11-10"
---
# Connect your AI tool

> Add the Affitor MCP server to Claude, Codex, ChatGPT, Cursor, VS Code, Grok, Muse Code or another MCP client, then sign in with Affitor. No API key needed.

Add the Affitor MCP server to your AI tool, then sign in with your Affitor account. No API key needed. You will add the server, sign in on affitor.com, choose your programs and click **Allow**.

## Before you start

- An Affitor account with a program, or a program you joined as a partner.
- Access is read-only today: reading is always on, and money actions always happen in Affitor.

## Server URL

```text
https://mcp.affitor.com/mcp
```

Every tool below uses this URL. For transport, sign-in and the full tool list, see the [MCP server reference](/docs/api-reference/mcp).

## Claude

Claude on the web and Claude Desktop.

1. Add the server in one click: [Add to Claude](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Affitor&connectorUrl=https%3A%2F%2Fmcp.affitor.com%2Fmcp).

Or add it by hand:

2. In Claude, open **Customize** › **Connectors**.
3. Click **+ Add**, then **Add custom connector**. Name it Affitor, paste the URL and click **Continue**.
4. Keep the detected sign-in settings. If Claude asks, pick **Register automatically** under **OAuth client**.
5. Click **Add** and sign in to Affitor.
6. As a brand, pick your programs; then click **Allow**.

On Team and Enterprise plans, an owner adds the connector in **Organization settings** › **Connectors**, and members click **Connect**.

**Check it works:** in a new chat, ask your AI tool "List my Affitor programs". It answers with your programs.

## Codex

1. Run this in your terminal:

   ```bash
   codex mcp add affitor --url https://mcp.affitor.com/mcp
   ```

2. Sign in:

   ```bash
   codex mcp login affitor
   ```

**Check it works:** run `codex mcp list`: affitor is listed. Then ask your AI tool "List my Affitor programs". It answers with your programs.

## Other MCP clients

Each section below matches a tab in the dashboard's **Connect an AI tool**, or a block under its **Other** tab. **Any other MCP client** also has steps for apps the dashboard does not list.

### ChatGPT

1. Go to [chatgpt.com/plugins](https://chatgpt.com/plugins), click the plus button, then **Add custom MCP server**.
2. Enter a name, and under **Connection** paste the URL.
3. Set authentication to OAuth, review the warning and click **I understand and want to continue**.
4. Click **Create as a plugin** and sign in to Affitor.
5. As a brand, pick your programs; then click **Allow**.

Your workspace's policy may limit who can add custom MCP servers.

**Check it works:** in a new chat, ask your AI tool "List my Affitor programs". It answers with your programs.

### Cursor

1. Add the server in one click: [Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=affitor&config=eyJ1cmwiOiJodHRwczovL21jcC5hZmZpdG9yLmNvbS9tY3AifQ%3D%3D).

Or add it by hand:

2. Add this to `~/.cursor/mcp.json`:

   ```json title="mcp.json"
   {
     "mcpServers": {
       "affitor": { "url": "https://mcp.affitor.com/mcp" }
     }
   }
   ```

3. In **Cursor Settings** › **MCP**, click **Connect** and sign in.

**Check it works:** in **Cursor Settings**, open **MCP**: affitor shows its tools. Then ask your AI tool "List my Affitor programs". It answers with your programs.

### Claude Code

1. Install the Affitor plugin (recommended):

   ```text
   /plugin marketplace add Affitor/claude-plugins
   /plugin install affitor@affitor
   ```

2. Open `/mcp`, pick affitor and sign in.

Or add the server by hand:

1. Run this in your terminal:

   ```bash
   claude mcp add --transport http affitor https://mcp.affitor.com/mcp
   ```

2. In Claude Code, type `/mcp`, pick affitor and sign in.

Add `--scope user` to use Affitor in every project.

**Check it works:** run `claude mcp list`: affitor shows `Connected`. Then ask your AI tool "List my Affitor programs". It answers with your programs.

### VS Code

GitHub Copilot in VS Code.

1. Add the server in one click: [Add to VS Code](https://vscode.dev/redirect/mcp/install?name=affitor&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.affitor.com%2Fmcp%22%7D).

Or add it by hand:

2. Add this to `.vscode/mcp.json` in your workspace, or to the `mcp.json` of your user profile (or run **MCP: Add Server** from the Command Palette):

   ```json title="mcp.json"
   {
     "servers": {
       "affitor": { "type": "http", "url": "https://mcp.affitor.com/mcp" }
     }
   }
   ```

3. Start the server and sign in when VS Code asks.

**Check it works:** in Copilot Chat in Agent mode, ask your AI tool "List my Affitor programs". It answers with your programs.

### Grok

1. Go to [grok.com/connectors](https://grok.com/connectors), click **New Connector**, then **Custom**.
2. Paste the URL and sign in to Affitor.
3. Pick your programs, or **All current and future programs**, then click **Allow**.

**Check it works:** in a new chat, ask your AI tool "List my Affitor programs". It answers with your programs.

### Muse Code

1. Add this to `~/.config/muse/settings.json` (create the file if it does not exist). If it exists, add only the `affitor` entry under `mcpServers` and keep everything else. Keep one `mcpServers` section. Having both `mcpServers` and `mcp_servers` disables MCP.

   ```json title="settings.json"
   {
     "schema_version": 1,
     "mcpServers": {
       "affitor": {
         "type": "streamable-http",
         "url": "https://mcp.affitor.com/mcp",
         "enabled": true,
         "required": false
       }
     }
   }
   ```

2. Sign in from your terminal:

   ```bash
   muse mcp login affitor
   ```

3. Pick your programs, or **All current and future programs**, then click **Allow**.

**Check it works:** in a Muse Code session, run `/mcp`: affitor shows its tools. Then ask your AI tool "List my Affitor programs". It answers with your programs.

### Any other MCP client

1. Add this to your client's MCP config:

   ```json
   {
     "mcpServers": {
       "affitor": { "url": "https://mcp.affitor.com/mcp" }
     }
   }
   ```

2. Restart the client and sign in when it asks.

Apps on your own computer connect through `http://127.0.0.1` or `http://localhost`. A web app connects only if Affitor accepts its return address; the [MCP server reference](/docs/api-reference/mcp) lists them.

**Check it works:** ask your AI tool "List my Affitor programs". It answers with your programs.

Some clients add the server with their own command or screen:

#### Gemini CLI

```bash
gemini mcp add --transport http affitor https://mcp.affitor.com/mcp
# Then, inside Gemini CLI: /mcp auth affitor
```

#### OpenClaw

```bash
openclaw mcp add affitor --url https://mcp.affitor.com/mcp --transport streamable-http --auth oauth
openclaw mcp login affitor
```

#### Hermes Agent

```bash
hermes mcp add affitor --url https://mcp.affitor.com/mcp --auth oauth
# To sign in again later:
hermes mcp login affitor
```

#### Perplexity

1. Open **Plugins** in the sidebar, or **Customize** › **Connectors** if you don't see Plugins.
2. Select **Add custom** › **Connector** › **Add MCP connector**, then **Remote**.
3. Enter a name, and under **MCP Server URL** paste `https://mcp.affitor.com/mcp`.
4. Under **Authentication** pick **OAuth** and under **Transport** pick **Streamable HTTP**. Affitor supports automatic registration, so no Client ID or Client Secret is needed.
5. Check the acknowledgement box, click **Add**, then click the connector card and sign in to Affitor.

In an organization, members can add custom connectors only if an admin allows it.

## What the AI can do

When you sign in, you choose the programs the AI can read. Access is read-only today: reading is always on, and money actions always happen in Affitor.

To see or remove a connection, brands open **Program settings** › **Developers** › **AI agents**; partners open **Integrations** from the account menu.

## Next: set up tracking

For brands: in the dashboard, **Program settings** › **Tracking** › **With AI** shows this prompt with your website, program ID and API base filled in. Paste it into your AI tool. It follows the [agent skill](/docs/skill.md): click tracking, sign-up leads, then sales.

<AgentPrompt prompt={`Add Affitor affiliate tracking to <your website>.

Program ID: <your program ID>
API base: https://api.affitor.com
API key: read it from the AFFITOR_API_KEY environment variable. Never print it or put it in browser code.

Follow https://affitor.com/docs/skill.md in order:
click tracking (§4), signup lead (§5), then the sale (§6).
For the sale, look at how the site takes payments and use the first mode in §6 that fits.
If you can't read or change the code, ask me what you need and tell me exactly what to add, file by file.
Then tell me when it's deployed.`} />

The prompt reads your program API key from the `AFFITOR_API_KEY` environment variable where the AI tool runs; never put the key in the prompt. Use a key with **Full access**: a **Tracking only** key cannot run the readiness check the skill ends with. If you do not have the key's value, an owner or admin creates or rotates one in **Program settings** › **Developers** › **API keys**. See the [tracking guide](/docs/brand/tracking/quickstart-integration).

## Related

- [MCP server reference](/docs/api-reference/mcp): transport, sign-in, tools and limits
- [AI agent setup](/docs/use-cases/ai-agent-setup): what an agent can do with your program
