Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developer.affinity.co/llms.txt

Use this file to discover all available pages before exploring further.

​
Supported Notion surfaces

Affinity’s MCP server is connected through Notion Custom Agents. The default Notion AI assistant (Ask AI, Q&A, search) does not support adding custom MCP servers. Only Custom Agents do. If you don’t see an Agents section in your sidebar, your plan or workspace settings don’t yet include Custom Agents.

​
Prerequisites

Affinity
  • Plan: Scale, Advanced, or Enterprise (required for API and MCP access).
  • For API key setup: Generate an Affinity API key first. See Authentication.
  • Admin setup: None required by default. If an Affinity admin has disabled Notion under Settings → Affinity MCP, ask them to re-enable it.
Notion
  • Plan: Business or Enterprise. Custom Agents and custom MCP servers are only available on these plans.
  • Admin setup (required): A workspace Owner must enable custom MCP servers and, if desired, restrict who can create agents. See the next section for steps.
Notion supports both OAuth and API key authentication.

​
Admin: Enable Custom MCP Servers

A workspace Owner must enable the feature for the workspace before any user can use it.
  1. Navigate to Settings → Notion AI → AI Connectors.
  2. Under MCP Connections, enable the toggle for Enable custom MCP servers.
  3. Optionally, navigate to Settings → Notion AI → Agents and update Control who can create agents to restrict agent creation to certain users.
Not an admin? Send this to your workspace Owner: “Can you enable Settings → Notion AI → AI Connectors → Enable custom MCP servers so I can connect to the Affinity MCP server?”

​
User: Create an Agent (OAuth)

  1. In the left sidebar, find the Agents section and click New Agent.
  2. In the module that appears, click Create blank in the top right.
  3. In the Tools and access section, click Add connection.
  4. In the Add connection module, click Add custom MCP in the bottom left.
  5. Enter the following configuration:
    • MCP server URL: https://mcp.affinity.co/mcp
    • Name: Affinity
    • Authentication: OAuth
  6. Click Connect to initiate the OAuth flow. Once authorized, click Save in the top right.
  7. The agent appears under the Agents section. Click on it to start chatting and using the MCP server.

​
User: Create an Agent (API Key)

Generate an Affinity API key first. See Authentication.
  1. In the left sidebar, find the Agents section and click New Agent.
  2. In the module that appears, click Create blank in the top right.
  3. In the Tools and access section, click Add connection.
  4. In the Add connection module, click Add custom MCP in the bottom left.
  5. Enter the following configuration:
    • MCP server URL: https://mcp.affinity.co/mcp
    • Name: Affinity
    • Authentication: Bearer (set the Token field to your API key)
  6. Click Connect. The MCP server will appear with its available tools.
  7. Click Save in the top right. The agent appears under the Agents section. Click on it to start chatting and using Affinity data.

​
Test your connection

Open the new agent and try one of these:
  • Find 3 companies I emailed in the last 30 days.
  • Show me my upcoming meetings.
  • Summarize recent activity on Acme Corp.
If Affinity data comes back, you’re set. If not, see Troubleshooting.