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 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. 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 and check the connection row for Connected.
MCP connections in Tilt with the Linear read-only endpoint entered in MCP server URL and an Add server button

Enter the provider's MCP endpoint in Settings > Connections.

Linear read-only MCP server in Tilt showing Connected, its server URL, and Reconnect and Disconnect buttons

A connected Linear read-only server in the Tilt desktop app.

Tilt keeps provider credentials server-side. The connection belongs to your Tilt user account and follows you across organizations. Switching organizations does not change the provider account you authorized or share your connection with other users.

​
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.

​
Use the connection

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

​
Reconnect or disconnect

Open Settings > Connections and find the server under MCP connections. 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

For an integration that sends tasks to Tilt Agent from another application, see Connect to Tilt Agent over MCP.