Docs
Integrations

Custom MCP

Connect a remote MCP server from the Agent page

You can add a custom remote MCP server to give the agent tools beyond the catalog.

Add a server

  1. Open Agent → MCPs and select the relevant account or chat context.
  2. Under Custom servers, choose New custom server.
  3. Enter a Server name and Endpoint URL for a reachable Streamable HTTP MCP server.
  4. If the server needs a bearer token, enter it in Auth token. Leave it blank for a server that does not require one.
  5. Choose Add, then check the installed connection and any discovery error before using it.

The server must be reachable from PlutoAI's server environment. A command that launches a local stdio server is not an endpoint URL. Use the endpoint and access requirements supplied by your server operator.

Import a configuration

Expand Import from a JSON config instead, paste a configuration containing a remote URL, and choose Import JSON. Review the populated fields before adding the server. The new-server form imports the first server entry; repeat for additional servers.

json
{
  "mcpServers": {
    "example": {
      "url": "https://mcp.example.com/mcp"
    }
  }
}

Enter real credentials in the protected token field. If the UI offers a separate review of older settings, inspect its listed entries and errors before saving; a saved setting and a successful connection are separate results.

Scope and errors

When adding from a chat, PlutoAI also tries to attach the saved server to that chat. If saving succeeds but attachment fails, the UI reports that distinction. Review the existing connection before retrying so you do not create unnecessary copies.

Only the connection owner can change protected settings or chat attachments. If settings changed elsewhere, reload and review the latest settings before saving your draft again.

See MCPs and MCP reference.