Connect other agents

The quickstart connects Claude Code, with a note for VS Code agent mode. Those two have been run against Retiform. This page covers three more agents.

These steps are in beta. They are written from each product's own documentation and from how Retiform's sign-in works, and nobody has yet run them against Retiform from start to finish. If you try one, please tell us what happened, whether it worked or not, at the support address at the foot of this page. Your report is how a step here moves out of beta.

What every agent needs

If sign-in does not start, or the agent says it cannot register, see "If it does not work" below.

claude.ai

Custom connectors are in every Claude plan. On the Free plan you can add one. On a Team or Enterprise plan, an owner adds the connector for the organisation, and each member then connects with their own sign-in.

  1. In claude.ai, open Customize, then Connectors. (Anthropic's documentation has also called this Settings, then Connectors.)
  2. Choose Add, then Add custom connector.
  3. Enter a name, such as Retiform, and your MCP address. Choose Continue.
  4. Leave the authentication options as detected. If you are asked how Claude should identify itself, choose Register automatically.
  5. Choose Add, then Connect, and sign in to Retiform as described above.
  6. In a chat, choose +, then Connectors, and switch Retiform on for that conversation.

On a Team or Enterprise plan, an owner does steps 2 to 4 under Organization settings, then Connectors. Members then find Retiform under Customize, then Connectors, and choose Connect.

Things to know:

Anthropic's instructions: "Getting started with custom connectors using remote MCP" at support.claude.com, and claude.com/docs/connectors/custom/remote-mcp.

Claude Desktop

Claude Desktop uses the same connectors as claude.ai. They belong to your Claude account, not to the application, so a connector you added on the web is already there.

  1. In Claude Desktop, open Customize, then Connectors.
  2. If Retiform is listed, choose Connect if it asks. If it is not, add it as in the claude.ai steps.

Do not add Retiform to claude_desktop_config.json. That file is for programs that run on your own computer, and Retiform is a remote service.

Cursor

Cursor reads its MCP servers from a file: .cursor/mcp.json in a project, or ~/.cursor/mcp.json for all your projects.

  1. Create or open the file and add Retiform, with your own MCP address:

    {
      "mcpServers": {
        "retiform": {
          "url": "<your MCP address>"
        }
      }
    }
    
  2. In Cursor, open Customize in the sidebar and switch the retiform server on.

  3. Cursor opens your browser to sign in. Sign in to Retiform as described above.

  4. Back in Cursor, check that Retiform's tools are listed under the server.

Things to know:

Cursor's instructions: cursor.com/docs/context/mcp.

If it does not work

What you see What to check
The agent says the address is wrong, or nothing happens The address must be the one from your invite, ending in /mcp, with https:// in front
No sign-in page opens Remove the server or connector and add it again. In claude.ai, choose "Register automatically" when asked how Claude identifies itself
You signed in, but the agent shows no tools You may not have approved the agent in Retiform's console. Open the console and look for a waiting approval
The console says the tenant has no room for another agent client The approval page offers to revoke an agent client of yours that is no longer used and approve the new one. If none is yours, ask a tenant administrator to revoke one, then connect again
A tool fails with INSUFFICIENT_SCOPE The agent was approved without that permission. Revoke it in the console and connect again, ticking what it needs
A tool or option the changelog describes is missing Your agent may keep the tool list it read before a release. Quit the agent and open it again: a reconnect alone may not refresh it
Something else Troubleshooting lists each error. Then write to us and say which agent you used and what it showed

Other agents

Any agent that supports the Model Context Protocol over HTTP with sign-in in the browser should be able to connect in the same way: give it the MCP address, and sign in when it asks. Retiform does not accept an API key in place of sign-in. We have not tried agents other than those named on this page and in the quickstart.