FeaturesConnectors

Connectors

Connect remote and local MCP tools from Settings or chat, with approval and provider-specific limits.

Connectors are available in Zyron Stable and Beta. Open Settings → Connectors, select a catalog entry, enter a public HTTPS MCP URL, or choose Add local server for a loopback HTTP URL or a stdio command. Complete any required sign-in in your browser. This lets an agent use another service's tools. External MCP works in the other direction, allowing outside agents to call Zyron.

You can also ask in a chat: “add the Paper MCP at http://127.0.0.1:29979/mcp” or “add stdio MCP: ~/.paper/bin/paper mcp”. Zyron shows a card before connecting or running anything. Choose Review connection to see the exact command, arguments, working directory and environment keys, then Approve connector; values stay hidden. Removing a connector also requires confirmation.

Cards show the app's icon when recognized, its name and connection status. A Custom badge identifies connectors outside the built-in catalog. Open Connection details to inspect their configuration.

“Import my Claude Code MCP servers” discovers user and current-project entries, plus Codex, workspace .mcp.json and Claude Desktop configurations. Accept only the cards you want. Imported commands are never executed during discovery. Custom HTTP-header authentication is not imported.

Start a connected session

After connecting, start a new provider session to receive the connector's tools. Existing sessions keep the set they started with. Mention a connected service in the composer to point the agent toward it; the provider still decides how to use its available tools. Third-party tool calls retain the provider's normal approval flow.

ProviderAvailability
Claude, Codex, OpenCodeRemote HTTP, local HTTP and stdio connectors are supported.
Cursor, Grok, Droid, Oh My PiUses ACP HTTP support or Zyron's stdio proxy.
Pi, Devin, AntigravityConnectors are unavailable.

Codex keeps user-configured servers: a connector with a conflicting server name is omitted. If its effective configuration cannot be checked, connectors are omitted for that session. OpenCode skips a connector that fails to start. A catalog entry does not guarantee that the service accepts your account or client registration.

Sign-in and recovery

Sign-in requires Zyron to listen only on loopback, because the callback returns to this machine. Custom endpoints use public HTTPS, or HTTP on localhost, 127.0.0.0/8 or ::1, and cannot embed URL credentials. Services that require a pre-registered OAuth application may reject automatic registration.

If a local app is closed, its connector remains saved as Not running. Unavailable connectors are omitted from new sessions. Start the app and allow the background status check to reconnect it, then start a new chat.

Slack requires your own OAuth application's client ID and secret. Copy the redirect URL shown in the dialog into that application. The desktop port changes after restart, so update the registered redirect URL before reconnecting.

When a service rejects refreshed credentials, the connector shows needs sign-in. Reconnect it from Settings. Disconnect removes locally saved tokens, invalidates pending sign-ins and attempts revocation when the service advertises it; already-running sessions then receive errors from that connector.

Data and channel boundaries

Connector credentials and local environment values stay in the server's local secret store. They are not returned in chat management-tool results. OAuth credentials stay in the gateway; configured environment values reach only the local MCP subprocess. Tool requests and their arguments are sent to the selected service. Review the service and the requested action before approving it.

Stable and Beta use the same connector functionality, but keep their own credentials and data homes. Sign in separately in each app; Beta credentials are not copied into Stable. See Zyron Beta.

Source evidence: docs/mcp-connectors.md, packages/contracts/src/mcpConnectors.ts, apps/server/src/mcpConnectors/runtime.ts, apps/server/src/agentGateway/connectorTools.ts, apps/server/src/agentGateway/mcpInjection.ts and apps/web/src/components/settings/McpConnectorsSettingsPanel.tsx.

Source evidence for 1.0.9: Zyron release ebd0d22b39ce3a0f7c6051dddc6090e9b85dc7c3; docs/releases/1.0.9-source-audit.md, docs/providers.md, docs/core-concepts.md, docs/editor/intelligence.md, docs/mcp-connectors.md, apps/server/src/persistence/MigrationBackup.ts and docs/release.md.

Last updated on