diff --git a/content/changelog/hosted-mcp-server.mdx b/content/changelog/hosted-mcp-server.mdx index 5f519585..b8cc0baf 100644 --- a/content/changelog/hosted-mcp-server.mdx +++ b/content/changelog/hosted-mcp-server.mdx @@ -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 diff --git a/content/docs/api-reference/mcp.mdx b/content/docs/api-reference/mcp.mdx index 50b0339a..dc20aa24 100644 --- a/content/docs/api-reference/mcp.mdx +++ b/content/docs/api-reference/mcp.mdx @@ -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 --- @@ -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" } + } }` }, { @@ -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) @@ -122,9 +132,28 @@ 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. --- @@ -132,7 +161,7 @@ After you sign in, Affitor sends you back to the app. It accepts only these retu 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.