# Connect an agent

Add Rizamo's MCP server to Claude, ChatGPT, Cursor or any MCP client, sign in, and give your agent its first task.

Rizamo's MCP server is `https://mcp.rizamo.com/mcp` (streamable HTTP). Your agent signs in with OAuth: you approve it in the browser and pick the profiles it can reach. No API key needed. Tools that cannot sign in send one instead ([Authentication](/authentication)).

Before you allow it, check where access goes: claude.ai for Claude, chatgpt.com for ChatGPT, an app on this computer for Claude Code, Codex and Cursor. An agent whose address Rizamo cannot check, such as the Gemini app, n8n or Zapier, reads Unverified: allow it only if you added it yourself.

## Claude [#claude]

In one click: [Add to Claude](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Rizamo&connectorUrl=https%3A%2F%2Fmcp.rizamo.com%2Fmcp).

1. In Claude, open Customize, then Connectors, and choose Add custom connector.
2. Name it Rizamo and paste the server URL.

   ```text title="Server URL"
   https://mcp.rizamo.com/mcp
   ```

3. Sign in to Rizamo and choose the profiles Claude can use.
4. In any chat, turn it on from + then Connectors.

## ChatGPT [#chatgpt]

1. Open chatgpt.com/plugins, choose + and then Add custom MCP server.
2. Name it Rizamo and paste the server URL.

   ```text title="Server URL"
   https://mcp.rizamo.com/mcp
   ```

3. Pick OAuth, create the plugin and sign in to Rizamo.
4. Install it from your plugins and type @Rizamo in a chat.

## Gemini [#gemini]

1. In the Gemini app, open Settings, then Connected Apps, and choose Add a custom app.
2. Paste the server URL, sign in to Rizamo, then mention @Rizamo in a chat.

   ```text title="Server URL"
   https://mcp.rizamo.com/mcp
   ```

3. In Gemini CLI, add the server and run /mcp auth rizamo to sign in.

   ```bash title="terminal"
   gemini mcp add --transport http rizamo https://mcp.rizamo.com/mcp
   ```

4. In Antigravity CLI, add it to ~/.gemini/config/mcp_config.json.

   ```json title="mcp_config.json"
   {
     "mcpServers": {
       "rizamo": {
         "serverUrl": "https://mcp.rizamo.com/mcp"
       }
     }
   }
   ```


For an agent setting itself up:

1. In Gemini CLI, run: gemini mcp add --transport http rizamo https://mcp.rizamo.com/mcp
2. Ask the user to run /mcp auth rizamo and sign in to Rizamo in the browser.
3. Call list_accounts and tell the user which accounts you can use. If the tools are missing, stop and tell the user.
4. Before publishing anything, create posts as drafts and get the user's confirmation.

## Perplexity [#perplexity]

1. In Perplexity, open Plugins, choose Add custom, then Connector, then Add MCP connector and Remote.
2. Paste the server URL and choose OAuth.

   ```text title="Server URL"
   https://mcp.rizamo.com/mcp
   ```

3. Sign in to Rizamo, then turn the connector on in a thread.

## Claude Code [#claude-code]

1. Add the server, then run /mcp to sign in.

   ```bash title="terminal"
   claude mcp add --transport http rizamo https://mcp.rizamo.com/mcp
   ```

2. Or use an API key.

   ```bash title="terminal"
   claude mcp add --transport http rizamo https://mcp.rizamo.com/mcp \
     --header "Authorization: Bearer $RIZAMO_API_KEY"
   ```

3. Share it with your team in .mcp.json.

   ```json title=".mcp.json"
   {
     "mcpServers": {
       "rizamo": {
         "type": "http",
         "url": "https://mcp.rizamo.com/mcp",
         "headers": { "Authorization": "Bearer ${RIZAMO_API_KEY}" }
       }
     }
   }
   ```


For an agent setting itself up:

1. Run: claude mcp add --transport http rizamo https://mcp.rizamo.com/mcp
2. Ask the user to run /mcp and sign in to Rizamo in the browser. Only ask for an API key if they prefer one.
3. Run claude mcp list and check that rizamo is connected. If it is not, stop and tell the user.
4. Call list_accounts and tell the user which accounts you can use.
5. Before publishing anything, create posts as drafts and get the user's confirmation.

## Codex [#codex]

1. Add the server. Codex opens the sign-in for you.

   ```bash title="terminal"
   codex mcp add rizamo --url https://mcp.rizamo.com/mcp
   ```

2. Or read an API key from your environment.

   ```bash title="terminal"
   codex mcp add rizamo --url https://mcp.rizamo.com/mcp \
     --bearer-token-env-var RIZAMO_API_KEY
   ```

3. Both write to ~/.codex/config.toml.

   ```toml title="config.toml"
   [mcp_servers.rizamo]
   url = "https://mcp.rizamo.com/mcp"
   bearer_token_env_var = "RIZAMO_API_KEY"  # omit to use OAuth
   ```


For an agent setting itself up:

1. Run: codex mcp add rizamo --url https://mcp.rizamo.com/mcp
2. Let the user finish the Rizamo sign-in in the browser.
3. Run codex mcp list and check that rizamo is listed. If it is not, stop and tell the user.
4. Call list_accounts and tell the user which accounts you can use.
5. Before publishing anything, create posts as drafts and get the user's confirmation.

## Cursor [#cursor]

In one click: [Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=rizamo&config=eyJ1cmwiOiJodHRwczovL21jcC5yaXphbW8uY29tL21jcCJ9).

1. Add Rizamo to ~/.cursor/mcp.json, or .cursor/mcp.json for one project.

   ```json title="mcp.json"
   {
     "mcpServers": {
       "rizamo": {
         "url": "https://mcp.rizamo.com/mcp"
       }
     }
   }
   ```

2. Open Cursor Settings, then MCP, and sign in to Rizamo.
3. Or skip the sign-in with an API key header.

   ```json title="mcp.json"
   "headers": { "Authorization": "Bearer ${env:RIZAMO_API_KEY}" }
   ```


For an agent setting itself up:

1. Add this entry to .cursor/mcp.json in the project, or ~/.cursor/mcp.json for every project: `{"mcpServers":{"rizamo":{"url":"https://mcp.rizamo.com/mcp"}}}`
2. Ask the user to open Cursor Settings, then MCP, and sign in to Rizamo.
3. Call list_accounts and tell the user which accounts you can use. If the tools are missing, stop and tell the user.
4. Before publishing anything, create posts as drafts and get the user's confirmation.

## VS Code [#vs-code]

In one click: [Add to VS Code](vscode:mcp/install?%7B%22name%22%3A%22rizamo%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.rizamo.com%2Fmcp%22%7D).

1. In VS Code, run Chat: Open Customizations, open MCP Servers and choose Add Server, then HTTP.
2. Paste the server URL, name it rizamo, then choose Global and Copilot Global.

   ```text title="Server URL"
   https://mcp.rizamo.com/mcp
   ```

3. Sign in to Rizamo when VS Code asks and choose the profiles Copilot can use.
4. Or add it to ~/.copilot/mcp-config.json yourself.

   ```json title="mcp-config.json"
   {
     "mcpServers": {
       "rizamo": {
         "type": "http",
         "url": "https://mcp.rizamo.com/mcp"
       }
     }
   }
   ```

5. A Copilot request takes up to 128 tools. Past that, turn off servers you do not need under Chat: Open Customizations, then Tools.

## Devin Desktop [#devin-desktop]

1. In Devin Desktop (formerly Windsurf), add Rizamo to ~/.config/devin/mcp_config.json, or .devin/mcp_config.json for one project.

   ```json title="mcp_config.json"
   {
     "mcpServers": {
       "rizamo": {
         "url": "https://mcp.rizamo.com/mcp"
       }
     }
   }
   ```

2. Open Customize, then MCPs, and refresh the list. Sign in to Rizamo when Devin asks and choose the profiles it can use.
3. In Devin CLI, add it for every project and sign in.

   ```bash title="terminal"
   devin mcp add -s user rizamo https://mcp.rizamo.com/mcp
   devin mcp login rizamo
   ```


## n8n [#n8n]

1. On an AI Agent node, add a tool and pick MCP Client Tool. Name it Rizamo.
2. Set the endpoint, Server Transport to HTTP Streamable and Authentication to Bearer Auth with your API key, or MCP OAuth2.

   ```text title="Endpoint"
   https://mcp.rizamo.com/mcp
   ```

3. For fixed steps with no agent, the MCP Client node runs one tool, or the HTTP Request node calls the API. Paste this with Import cURL.

   ```bash title="curl"
   curl https://api.rizamo.com/v1/posts \
     -H "Authorization: Bearer $RIZAMO_API_KEY"
   ```

4. To react to new comments or published posts, add an n8n Webhook trigger and paste its URL as a webhook in Rizamo.

## Make [#make]

1. Add an MCP Client module and create a connection with a new MCP server. Paste the URL and your API key, or sign in with OAuth.

   ```text title="URL"
   https://mcp.rizamo.com/mcp
   ```

2. Use Call a tool for a fixed step, or Execute an action with AI to let Make pick the tools.
3. In Make AI Agents, choose Add MCP on the Run an agent module and select the Rizamo tools.
4. To start scenarios from Rizamo, add a Custom webhook and paste its URL as a webhook in Rizamo.

## Zapier [#zapier]

1. Add a connection to MCP Client by Zapier. Paste the server URL, pick Streamable HTTP, and sign in with OAuth or paste your API key as the bearer token.

   ```text title="Server URL"
   https://mcp.rizamo.com/mcp
   ```

2. In a Zap, add the Run Tool action and choose a Rizamo tool, such as create_post.
3. To start Zaps from Rizamo, use Webhooks by Zapier, Catch Hook, and paste its URL as a webhook in Rizamo.

## First task [#first-task]

Once your agent is connected, ask it:

> Connect my social accounts to Rizamo. Then draft a first post for tomorrow at 9:00 and show it to me before scheduling it.

It sends you a link to log in on the network and pick your accounts ([Connecting accounts](/connecting-accounts)), then makes the draft. You see both in the web app.

## Troubleshooting [#troubleshooting]

- **The sign-in keeps coming back, or calls answer `401`:** remove Rizamo from your agent, add it again and sign in once more. When you allow it, check the profiles you pick: the agent reaches only those. An agent removed in the web app, under **Developers**, **Connected agents**, stops at once and has to sign in again.
- **Allow asks you to sign in again:** letting an agent in needs a sign-in from the last 15 minutes. Sign in again and you come back to the same page.
- **New or changed tools do not show:** an agent keeps the tools and instructions it read when it connected. In Claude Code, run `/mcp` and reconnect Rizamo; in VS Code, run MCP: Reset Cached Tools. In other agents, remove Rizamo and add it again, or restart the app.