Skip to main content
The MCP client integration lets you connect remote MCP servers to your Relevance AI agents using preset connections (Notion, Canva, Atlassian) or custom server URLs. This gives your agents access to tools hosted on external platforms without rebuilding them in Relevance AI.
This page is about connecting external MCP servers to Relevance AI agents. If you want to use Relevance AI from an AI client like Claude or Cursor, see Programmatic GTM.

​
Setting up an MCP connection for Agents

Agents can connect to and run tools from remote MCP servers. You can choose from preset connections for popular services or connect your own custom MCP server.
  1. Open the Agent you want to connect
  2. Navigate to the Tools tab in the agent builder
  3. Click Add MCP
  4. Choose your connection type:
    • Preset connections: Select from Notion, Canva, or Atlassian — follow the OAuth flow to authorize access and tools are configured automatically
    • Custom connection: Click Connect my own, add the server URL, label the connection, and enter any required authentication details
Once connected, the agent automatically fetches and displays available tools from the MCP server. These tools can be referenced in the agent’s core instructions and appear in the conversation task view.
Local MCP server support (e.g. JSON configuration) is not available.

​
Troubleshooting

  • Verify the MCP server URL is correct and the server is online
  • Check that any required authentication credentials are entered correctly
  • Ensure the external MCP server supports the Streamable HTTP transport
  • Confirm the tools are listed in the agent’s Tools tab after connecting
  • Check that the external MCP server has not revoked access or changed credentials
  • Try disconnecting and reconnecting the MCP server in the agent builder
  • The external MCP server may be temporarily unavailable — try again later
  • Check that the server URL does not require VPN or network access that Relevance AI cannot reach
  • For preset connections, try disconnecting and reconnecting to refresh the OAuth token
  • Contact the MCP server provider if the issue persists

​
Frequently asked questions (FAQs)

You can connect any remote MCP server that supports the Streamable HTTP transport. This includes servers from services like Linear, Notion, GitHub, and any custom MCP servers you host.
Yes. You can add multiple MCP server connections to a single agent, giving it access to tools from several external services at once.
No. Relevance AI only supports remote MCP servers accessible via a public URL. Local MCP servers running on your machine (e.g. via JSON configuration) are not supported.