Why connect an MCP server to Slate?
An MCP server adds tools Slate doesn’t have built in, such as documentation search or an internal API.Prerequisites
- The Admin role in your Slate workspace. Members can see connected servers but can’t add them.
- The URL of a public HTTPS MCP server that uses Streamable HTTP. Local (stdio) servers and multiple headers aren’t supported.
- The server’s credentials, if it requires them
Add a server
Step 1: Enter the connection details
- Open Workspace settings → Integrations.
- On the MCP servers card, click Add server.
- Enter a Connection name (up to 80 characters).
- Enter the MCP server URL.
- Choose an Authentication option:
Slate encrypts saved credentials and can’t show them again.
Step 2: Connect with a token, header, or no authentication
- Click Test connection. Slate connects and discovers the server’s tools.
- On Review MCP server, check the “Connected to” host.
- Under What can Slate use this for?, add up to six comma-separated capability hints, such as
official documentation, code samples. - Optionally turn on Run write tools without approval (see Write approval).
- Click Connect server.
Step 2 (OAuth): Connect with OAuth
- Optionally enter Capabilities as comma-separated hints.
- Optionally turn on Run write tools without approval.
- Click Connect with OAuth. The server’s consent page opens in a new window.
- Approve access. Slate discovers the server’s tools after consent.
How Cowork uses MCP tools
Cowork uses the connection name and capability hints to decide when a server fits your request. Cowork works with up to 10 connected servers per workspace, starting with the earliest added.- Tools the server marks as read-only run automatically.
- Write tools, and tools the server doesn’t classify, need approval before they run.
Approve a write tool
When Cowork wants to run a write tool, it shows a card titled Run followed by the tool name: “Slate wants to make this change on your behalf — it needs your OK first.”- Expand Review details to see the exact inputs.
- Click Approve to run the tool, or Deny to decline.
Write approval
Run write tools without approval lets Slate run write and unclassified tools from a server without asking. Only Admins can change it. Replacing a server’s authentication, or reconnecting OAuth, turns approval back on.Manage a server
Open the ⋮ menu on a server’s row:- Edit settings — change the name, Capabilities, authentication, or write approval, then click Save changes.
- Test connection — recheck the server and refresh its tool count.
- Disconnect — remove the server.
Reconnect a server
An OAuth server shows Reconnect needed when its access expires or is revoked. Cowork can’t use it until it’s reconnected.- Click Reconnect on the server’s row. The dialog shows “OAuth access expired or was revoked. Reconnect to use this server again.”
- Click Save changes. The server’s consent page opens in a new window.
- Approve access. Slate confirms: “OAuth reconnected. Write approval is required again.”
- In the ⋮ menu, choose Edit settings.
- Turn on Replace authentication and re-enter the exact server URL and new credentials.
- Click Save changes.
Troubleshooting
What’s next
- Cowork — ask Slate to research, write, and run tools
- Claude MCP Connector — use Slate from Claude