Skip to main content
Connect an external service through the Model Context Protocol (MCP) so Tilt Agent can use that service’s tools in your chats. This guide connects Linear with its read-only MCP endpoint.

Before you start

You need access to MCP connections in Tilt and an account with the provider you want to connect. Open Settings > Connections to check whether the MCP section is available to you. Use the provider’s public HTTPS MCP server URL. Tilt supports servers that need no sign-in and servers that advertise compatible OAuth authorization with PKCE. Localhost servers, private network addresses, and URLs containing credentials, query parameters, or fragments are unsupported. Sign in through the provider’s authorization page; keep passwords and API keys out of chat and the URL field. For this walkthrough, use:
Linear’s read-only endpoint exposes tools for reading Linear data. Review the provider’s consent page to confirm the account, workspace, and permissions you are authorizing.

Connect from Settings

  1. Open your user menu and select Settings.
  2. Select Connections, then find MCP connections.
  3. Select Add, paste the Linear endpoint into MCP server URL, and select Add server. Tilt discovers the server’s authorization requirements.
  4. On Linear’s authorization page, sign in and review the requested access. Authorize Tilt for the workspace you want to use.
  5. After authorization, return to Tilt. The server’s row shows a check under Status once it’s connected.
To find a server in a long list, type part of its name or web address in Search, or use the filter button beside it to show only Connected or Not connected servers.
MCP connections in Tilt with the Add form open, the Linear read-only endpoint entered in MCP server URL, and an Add server button

Select Add, then enter the provider's MCP endpoint.

MCP connections list in Tilt with Search, a filter button and Add above a table of Connector, Server and Status: two servers with a check, and one with a warning sign and a Connect button

Servers in Settings > Connections: a check means connected, and a warning sign means the server needs you to connect it.

Tilt keeps provider credentials server-side. A connection is yours in the organization you made it in, and nobody else in that organization can use it. Each organization you work in has its own connections, sign-ins and tool permissions, so to use the same server in another organization, connect it again there.

Connect from chat

You can also ask Tilt Agent to prepare a connection:
Tilt Agent discovers the server and presents a confirmation card. Review the server URL, active organization, provider scopes, and Tilt callback hostname. Select Connect to begin provider authorization, or Cancel to leave the connection unchanged. Discovery alone does not authorize access. Complete the provider’s authorization flow. Tilt then confirms the connection in chat; its tools are available on your next turn. If a confirmation has expired or its context has changed, ask Tilt Agent to prepare a new one. For a server that needs no sign-in, the card says so, and Connect connects it right away. If the provider must approve Tilt first, Tilt Agent tells you and prepares no card; see Provider approval required under Resolve a connection problem.

Use the connection

After connecting, ask Tilt Agent for an outcome that uses the provider. For example:
The provider’s tools, your authorized access, and your tool permissions determine what Tilt Agent can do. With the Linear read-only endpoint, requests can read data; they cannot create or update Linear issues.

Choose what Tilt Agent may do with each tool

Each app labels its own tools: some as tools that only read data, others as tools that can change or delete data. Tilt can’t check those labels. Out of the box, Tilt Agent runs a tool the app labels read-only on its own, and every other tool needs your approval, including a tool the app doesn’t label at all. To change that for one app:
  1. Open Settings > Connections and find the server under MCP connections.
  2. Select the server’s name. Its page shows the app’s name and its server’s web address, with a button to copy it, then lists the tools the app offers Tilt Agent under Tool permissions.
  3. Set a tool with the three icons beside it: Always allow (a check in a circle), Needs approval (a raised hand), or Blocked (a circle with a line through it). Point at an icon, or move to it with the keyboard, to see its name.
  4. To set every tool in a group at once, open the menu beside the group’s name and choose a setting. The menu shows Custom when the group’s tools don’t all have the same setting. Select a group’s name to collapse or expand it.
You can also open the page from a chat. A connected app’s card has a Tool permissions button next to Details. Under each of Tilt Agent’s answers, a line names each connected app tool it called without asking you, such as “Used Get market chart on Market Charts”; a call you approve shows on its approval card instead. The gear at the end of that line, the gear at the end of each “You ran” line on a connected app’s card, and the Tool permissions link on an approval card open the page at their tool and highlight it for a moment.
The page for mcp.deepwiki.com: its server URL with a copy button, Tool permissions with the line Choose when Tilt Agent is allowed to use these tools, then Write/delete tools with a count of 3 and a Needs approval menu, and three tools, each with three icon choices and Needs approval selected

A test server whose tools carry no labels, so every tool is under Write/delete tools and needs approval.

The app’s own views in a chat follow the same choices for these tools. When a view calls a tool that needs your approval, Tilt asks you before the call runs. A tool the app keeps for its view alone isn’t listed here, and Tilt runs it right away when the view asks. See When a view runs a tool. The page groups tools, with the number of tools beside each group’s name and the tools in each group sorted A to Z. Interactive tools holds the tools that come with the app’s own view (see See an app’s own view). Read-only tools holds the other tools the app labels as ones that only read data. Write/delete tools holds every other tool, including tools the app doesn’t label. Tilt Agent uses your choices from its next turn. A turn that’s already running can take several minutes to pick them up. A tool the app adds later starts with the default for its label until you choose otherwise. If Tilt can’t reach the app to list its tools, the page says so; select Retry to try again. To list the app’s tools again at any time, open the more actions menu beside Disconnect and select Refresh tools list. Automations can’t ask you during a run, so a tool that needs approval doesn’t run in an automation. Set a tool to Always allow if an automation has to use it. A background job can’t ask you either: it stops and asks Main chat to check the call with you. Chats started from another app, such as Claude, don’t use the tool either.

Approve or deny a call in the chat

When Tilt Agent wants to use a tool that needs approval, it stops and shows a card in the chat. The card names the app, its real web address, and the tool, and lists every value Tilt Agent wants to send, exactly as it would send them. The app’s name and the tool’s title come from the app.
  • Allow once sends that exact call to the app, once. Tilt Agent then carries on from the app’s answer. If the tool comes with its own view, such as a chart, Tilt shows the view below the card.
  • Always allow sets the tool to Always allow on its Tool permissions page, then sends the call once, like Allow once. From then on Tilt Agent uses the tool without asking. If Tilt can’t save the setting, the call is still allowed once and the card says so. The card offers it only for a tool you haven’t set yourself: a tool you set to Needs approval keeps asking.
  • Deny sends nothing, and Tilt Agent is told you declined.
A card nobody answers expires after 24 hours and counts as denied. If the app changes the tool, stops offering it, or you set it to Blocked before the call goes out, Tilt doesn’t send it and the card says so.

See an app’s own view

Some apps send their own view with a result, such as a chart with buttons. Tilt shows it in the chat inside a card labelled Connected app. Everything inside the card’s frame is the app’s own page. Tilt draws the frame around it: the app’s name and web address, and a line for each action the view runs that can change something in the app. When the view uses one of the tools the app also offers Tilt Agent, Tilt follows your choices on the app’s Tool permissions page and asks you first when a tool needs your approval. For what each part of the card means, what a view can and can’t do, and what Tilt Agent sees, read Connected app views.

Reconnect or disconnect

Open Settings > Connections, find the server under MCP connections, and select its name to open its page. You can also ask Tilt Agent to reconnect or disconnect a server in chat. Review the confirmation card and select the matching action. A request to disconnect prepares a confirmation; Tilt applies it when you select Disconnect.

Resolve a connection problem

A server that isn’t connected shows a warning sign and a Connect or Retry discovery button on its row in Settings > Connections. Point at the button to see why, or open the server’s page, which names its status. For an integration that sends tasks to Tilt Agent from another application, see Delegate to Tilt Agent from your application.