Getting There
Go to Manage → MCP Connectors. It’s an Advanced page, so it isn’t in the starting sidebar. Add it with Customize sidebar, or open it from the Manage page or with Cmd/Ctrl+K. See Navigating Studio.The Connectors List
Each connector shows its name, a status chip, its transport, the server’s host, how many tools it has and when its tools were last found. Search by name with Search connectors by name, and select New Connector to add one. The status chip tells you how the last look for tools went:Adding a Connector
Select New Connector to open the New MCP connector drawer.Test and Save
- Test connection checks the details you’ve entered, saved or not. It reports each step (the Auth Profile, the connection and the list of tools) and shows the server’s name and version when it answers. Nothing is saved.
- Save and find tools saves a new connector and asks the server for its tools. If the server can’t be reached, the connector is still saved and shows Needs attention, with the step that failed. Fix the problem, then use Refresh tools.
- Refresh tools asks a saved connector’s server for its tools again, using the saved settings, so save any changes first. Under Since the last refresh it lists the tools that are New, Changed or Removed, and which agents use a changed or removed tool, each tagged Published, Draft or both. Those agents keep the tool as it was when it was added until you review it on each agent.
The Tools List
A saved connector lists the tools its server offers, each with its description and required arguments. Select Show input schema to see the full schema. A tool can carry a badge from the server’s own hints: Read-only, or Can change or delete data. A tool with no hint has no badge.Giving an Agent a Tool
Add a tool to an agent from the Integrations button on its In-conversation Actions card. Each tool you pick becomes its own action with a flow you can edit. See Add a Tool From an MCP Connector.Changing and Publishing
A connector is shared by your whole account, so what you save on it, such as its URL, timeout or Auth Profile, applies at once to every agent that uses it, including published agents, with no Publish. Which tool an action uses is part of the agent, so on a published agent, adding a tool or changing the tool an action uses reaches callers at your next Publish. See What Waits for Publish.When a Tool Is Called
During a conversation the agent calls the tool with the arguments it worked out from the caller. If a call fails, the agent is told it failed and can tell the caller. Keep your tools quick, because a call that runs past the Timeout fails.Deleting a Connector
Select the Delete icon next to a connector. SquawkVoice first checks whether an agent uses it:- Not in use: a Delete MCP connector? confirmation appears. Select Delete Connector to confirm. The connector and its list of tools are deleted, and this can’t be undone.
- In use: a dialog lists AI agents using this connector, each tagged Published, Draft or both, and the connector can’t be deleted. Remove its tools from those agents first, and publish any agent tagged Published, then try again.