Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion content/changelog/hosted-mcp-server.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ description: The hosted Affitor MCP server at mcp.affitor.com lets AI apps read
version: "Affitor MCP 0.1.2"
---

You can now connect Claude, ChatGPT, Cursor, Claude Code, Codex and other AI apps to Affitor with one URL, `https://mcp.affitor.com/mcp`, and ask about your program in plain words. You sign in with your Affitor account; there is no API key to copy.
You can now connect Claude, ChatGPT, Cursor, VS Code, Perplexity, Claude Code, Codex and other AI apps to Affitor with one URL, `https://mcp.affitor.com/mcp`, and ask about your program in plain words. You sign in with your Affitor account; there is no API key to copy.

## Add it to your AI app

Expand Down
35 changes: 32 additions & 3 deletions content/docs/api-reference/mcp.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Affitor MCP server
description: Connect Claude, ChatGPT, Cursor, Claude Code, Codex and other AI apps to your Affitor program or partner account at https://mcp.affitor.com/mcp. Sign in with your Affitor account; access is read-only.
description: Connect Claude, ChatGPT, Cursor, VS Code, Perplexity, Claude Code, Codex and other AI apps to your Affitor program or partner account at https://mcp.affitor.com/mcp. Sign in with your Affitor account; access is read-only.
kind: reference
last_updated: 2026-10-16
---
Expand Down Expand Up @@ -67,6 +67,15 @@ codex mcp login affitor`
"mcpServers": {
"affitor": { "url": "https://mcp.affitor.com/mcp" }
}
}`
},
{
label: "VS Code",
lang: "json",
code: `{
"servers": {
"affitor": { "type": "http", "url": "https://mcp.affitor.com/mcp" }
}
}`
},
{
Expand Down Expand Up @@ -100,6 +109,7 @@ hermes mcp login affitor`
cursor://anysphere.cursor-deeplink/mcp/install?name=affitor&config=eyJ1cmwiOiJodHRwczovL21jcC5hZmZpdG9yLmNvbS9tY3AifQ%3D%3D
```

- **VS Code:** put the JSON in `.vscode/mcp.json` in your workspace, or in the `mcp.json` of your user profile, or run **MCP: Add Server** from the Command Palette. Start the server and sign in when VS Code asks.
- **Other clients:** put the JSON in the client's MCP config, restart it and sign in when it asks.

### Claude (claude.ai and Claude Desktop)
Expand All @@ -122,17 +132,36 @@ On Team and Enterprise plans, an owner adds the connector in **Organization sett

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

### 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.

### Which apps can connect

After you sign in, Affitor sends you back to the app. It accepts only these return addresses: `claude.ai`, `claude.com`, `chatgpt.com`, `www.cursor.com`, and apps on your own computer (`http://127.0.0.1` or `http://localhost`, any port). An app that registers any other web address is refused when it registers. VS Code registers `vscode.dev`, so it cannot connect.
After you sign in, Affitor sends you back to the app. It accepts only these return addresses:

- `claude.ai` and `claude.com` (Claude)
- `chatgpt.com` (ChatGPT)
- `www.cursor.com` (Cursor)
- `vscode.dev/redirect` and `insiders.vscode.dev/redirect` (VS Code)
- `www.perplexity.ai/rest/connections/oauth_callback` (Perplexity)
- apps on your own computer: `http://127.0.0.1` or `http://localhost`, any port

An app that registers any other address is refused when it registers, with the error "redirect_uris must be https on a supported AI app host, or http on 127.0.0.1 or localhost". Organizations that use Perplexity on its Enterprise address, `enterprise.perplexity.ai`, cannot connect: that address is not on the list.

---

## Sign in and allow access

When your AI app connects, your browser opens **Connect an AI tool** on affitor.com. If you are signed out, you sign in first and come back to the same screen.

1. The title names the app: **Claude wants to access Affitor**, or **An app on this computer wants to access Affitor** for a desktop or terminal app. An app whose return address is not on the list above shows **Unverified**, and its name in quotes, because any app can call itself "Claude".
1. The title names the app: **Claude wants to access Affitor**, or **An app on this computer wants to access Affitor** for a desktop or terminal app. A desktop or terminal app also shows **Unverified** and the name it gives itself in quotes ("It calls itself …"), because any app on your computer can call itself "Claude".
2. Check **Signed in as** your email. To use another Affitor account, click **Switch**.
3. If you are both a brand and a partner, choose **As a brand** or **As a partner**.
4. A brand picks one **Program**. You need to be an active member of that program. A partner sees **Programs**: all programs you are a partner in.
Expand Down
Loading