Browse documentation

Connectors (MCP)

Connect agents to external tools and data through MCP connectors.

A connector plugs an outside service into Spark so your agents can use it. Connectors follow the Model Context Protocol (MCP), an open standard for exposing tools and data to AI agents. Each active connector contributes a set of tools that you can then add to an agent.

Open the Connectors page

  1. In the left sidebar, open the Settings tab.
  2. Under Agent, select Connectors.

The page splits connectors into two sections:

  • Active: connectors currently providing tools to your agents.
  • Available: connectors you can activate to unlock additional tools.

Each row shows the connector's name, a description, and the number of tools it provides. Spark is the built-in connector: it exposes the platform's own tools, is always active, and cannot be deactivated. Connectors marked as experimental show a flask icon and may not be fully wired yet.

The Connectors page with an Active section (including the built-in Spark connector) and an Available section of connectors to activate.
The Connectors page: Active connectors provide tools now; Available ones can be turned on.

Activate a connector

  1. Find the connector in the Available section.
  2. Open its more menu (⋮) and choose Activate.

To preview what a connector offers before turning it on, use See tools from the same menu. Once active, a connector's tools become selectable in the agent editor.

A connector's more menu open, showing Activate and See tools.
An available connector's ⋮ menu: Activate it, or See tools to preview first.

Manage or turn off a connector

From an active connector's more menu (⋮):

  • Manage opens the connector's detail page, where its tools are grouped by area (for example read, update, write) and each has an Allow toggle so you can enable or disable individual tools across the workspace.
  • Deactivate stops it from providing tools (not available for the built-in Spark connector).
A connector detail page listing its tools grouped by area, each with an Allow toggle.
On a connector's detail page, toggle individual tools on or off with Allow.

Credentials live in vaults

Activating a connector does not ask for a password. Connectors that need to authenticate (with an API key or OAuth) read their credentials from a vault at the moment the agent runs. You add those credentials in a vault, and bind the vault to the agent. See Vaults for the full flow.

An agent only gains a connector's tools when you add those tools to it in the agent editor. Activating the connector makes the tools available; selecting them wires them to a specific agent.

Where to go next