Documentation
Open app

MCP servers

On this page

MCP servers give the assistant tools. Where Integrations let the assistant read your documents, MCP servers let it do things — open a Linear issue, post in Slack, push to a Notion database, run a query in your internal API. "MCP" stands for Model Context Protocol: an open standard for exposing tools to AI agents.

Typical providers: Linear · Notion · Slack · GitHub · Asana Setup: workspace admin Use: every workspace member

Integration vs MCP — what's the difference#

AspectIntegrationMCP server
What it doesBrings the system's documents into the knowledge base.Gives the assistant tools to act in the system.
The assistant can…Read the content and cite it in answers.Do things — create, update, query live data.
Data freshnessA snapshot from the last sync; re-sync to update.Live — the assistant calls the system in the moment.
Use it whenYou want answers grounded in your team's documents.You want the assistant to perform tasks, not just answer.

For workspace admins — register an MCP server#

1

Open MCP servers

From the workspace console choose MCP Servers. The screen lists every server connected to this workspace.

The MCP Servers screen: a list of connected servers on the left and, on the right, the selected server with its status, transport, auth type and tool inventory
The list shows every registered server; selecting one reveals its transport, auth and the tools it exposes.
2

Add a server

Click Add server. Fill in a Name, the server's HTTPS URL, and an Auth method (OAuth for SaaS apps, API key for internal tools, or None).

The add-MCP-server dialog with a name, server URL, transport selector and, under Advanced, the authentication method and a prompt hint
Adding a server needs its URL and transport; authentication and a prompt hint sit under Advanced.
3

Authenticate

For OAuth servers, click Connect and approve the scopes in the browser. For API-key servers, paste the key into the form — it's encrypted and never shown again.

4

Test and refresh tools

Use the Test button to confirm the connection. Then click Refresh tools to pull the server's tool catalog into the workspace.

5

Allow tools per workspace

The tools are available to the assistant automatically once the server is connected. You can restrict which tools appear by toggling them off here. Anything toggled off is invisible to the assistant.

Common MCP servers#

ServerWhat the assistant can doAuth
LinearCreate / read / update issues, comments, and assigneesOAuth
NotionSearch pages, create pages, update database rowsOAuth
SlackPost messages, read channels, look up usersOAuth
GitHubRead PRs, leave comments, search code, trigger workflowsOAuth or PAT
AsanaList tasks, create tasks, update statusOAuth
Internal HTTP MCPWhatever your engineers exposeAPI key
Be deliberate about what you allow

The assistant will use any tool you give it when it thinks it's helpful. Don't expose destructive tools (delete, drop, force-push) unless the assistant's role explicitly needs them.

Contents

Esc

Search titles and body text across every chapter.