Connectors
User connectors
Bring MCP servers and model providers to your agents.
Connectors (in the Workspace group) let each user connect outside tools to Converge for use by their agents.
Kinds
| Kind | What it connects |
|---|---|
mcp | A remote MCP server, whose tools become agent tools |
model | Your own model provider account |
actions | A native provider with built-in actions (see Native actions) |
Connections authenticate with OAuth 2.1 with PKCE, OAuth 2.0, an API key, or no authentication, depending on the provider.
Ownership and credentials
- Each connection belongs to the user who created it. Nobody else can use or see it.
- Credentials are sealed when stored and are never returned by the API. The AI service sees only the list of tools and their results.
Confirmation rules
A hint from an MCP server that a tool is read-only is accepted only as a hint for reads.
Safety limits
- Tool output reaches the model marked as untrusted external content.
- Calls must use HTTPS to an allowed host, and redirects are not followed.
- Requests and responses are size-limited, calls time out after 30 seconds, and an agent is offered at most 40 connector tools.
| Method | Path | Does |
|---|---|---|
| GET | /api/v2/connectors/catalog | Available connectors |
| GET, POST | /api/v2/connectors/connections | Your connections |
| POST | /api/v2/connectors/connections/{id}/authorize | Start authorization |
| POST | /api/v2/connectors/connections/{id}/test | Test a connection |
| DELETE | /api/v2/connectors/connections/{id} | Remove a connection |