External MCP connectors let your IQ Agents work with tools outside Whatagraph. You can connect from a catalog of supported tools, such as a project tracker, a data warehouse, or a messaging app, or add your own custom MCP server. Once a connector is set up, an agent can use it as part of a task, such as opening a ticket when a source breaks or looking up an account in your CRM. This article covers how to add a connector, connect your own account, and enable it on an agent. For a wider introduction to agents, see What are IQ Agents?.
How connectors work
There are three stages, and it helps to know them before you start:
Add the connector - define the external tool for your team. This makes it available, but doesn't connect anyone yet.
Connect your account - sign in to the tool so the connector can act on your behalf. Each person connects their own account.
Enable it on an agent - turn the connector on for a specific agent so it can use the tool.
Note: Adding a connector and enabling it on an agent are two separate steps. A connector that's connected to your team still won't be used until you switch it on for the agent that needs it.
Add a connector to your team
Step 1. Go to Settings → MCP Connectors in the left-hand navigation.
Step 2. Click "Add MCP connector".
Step 3. Pick a connector from the catalog, or add a custom MCP server by entering its address and credentials.
Step 4. Save. The connector is now set up for your team. The next step is to connect your account to it.
Connect your account
Step 1. Find the connector you just added in Settings → MCP Connectors.
Step 2. Click "Connect".
Step 3. For a catalog connector, sign in to the tool and approve access. For a custom server, enter the required credentials.
Your connection is now active. By default, it is personal to you; only you can act through it until you choose to share it.
Note: You can also connect an MCP connector by going to IQ agents → Connect in the right-hand navigation.
Enable a connector on an agent
Step 1. Open the agent in the Agent Builder.
Step 2. Click "Edit"
Step 3. Go to the External connectors panel.
Step 4. Toggle the connector on. Every connector you enable here becomes available to that agent on each run.
Share a connector with your team
By default, each person connects their own account. If you'd rather not have every colleague connect separately, you can share your connection so teammates who haven't connected their own can use the tool.
Step 1. In Settings → MCP Connectors, open the connector.
Step 2. Select Share with Team and click Share in the pop-up window.
When you share a connection, teammates without their own connection will act as you on that external tool. Only one shared connection is active per connector, so sharing a new one replaces any previously shared connection.
Important: A shared connection uses your identity and permissions on the external tool. Only share when you're comfortable with colleagues acting as you on that service.
Disconnect or remove a connector
Disconnect your own connection. This removes only your connection to the tool. The connector stays defined for the team; every agent who is enabled on keeps it, and other people's own connections aren't affected.
Important: If the connection you disconnect is the one you'd shared with the team, you also remove the fallback that teammates without their own connection were using. Any agent that was running on that shared connection loses access to the tool until someone provides another connection - their own, or a newly shared one.
Delete the connector. Deleting the connector itself (in Settings → MCP Connectors) is team-wide. It removes every member's connection and deletes the connector from every agent that had it enabled. The agent no longer has that tool at all, not just paused. Only admins and managers can delete a connector.
Who can manage connectors?
Adding, editing, sharing, and enabling connectors on agents is limited to admins and managers, who are also the only ones able to edit agents.
Note: External connectors are part of Whatagraph's agentic plans. Once a connector is set up, an agent can use whatever the tool allows, which may include making changes inside it, such as adjusting a Facebook Ads campaign.