<!-- https://developers.silktide.com/guides/connect-an-ai-client | Get started -->

# Connect Claude, ChatGPT or Cursor

Silktide runs an MCP server, so AI clients you already use, such as Claude, ChatGPT and Cursor, can work with your Silktide account. A connected client can do what the Silktide Agent does in Silktide: look at your websites, test results, issues, tasks and goals, explain how a check works and how to fix what it found, and search Help.

You do not need an API key or any code. You sign in to Silktide from the client, once, and choose which account it works in.

## The server address

Each region has its own server. Use your account's region:

| Region | MCP server address |
| --- | --- |
| Europe | `https://mcp.eu.silktide.com/mcp` |
| United States | `https://mcp.us.silktide.com/mcp` |
| Australia | `https://mcp.au.silktide.com/mcp` |

Silktide shows the same address, with steps for each client, under **Settings**, then **MCP**. If you are not sure of your region, see [Find your region](https://developers.silktide.com/guides/quickstart.md#find-your-region).

The server uses Streamable HTTP and signs you in with OAuth. When you sign in you pick one account, and the client works in that account until you connect again.

## Claude

On the web or in the desktop app:

1. Select your name in the bottom corner, then **Settings**, then **Connectors**.
2. Select **Add**, then **Add custom connector**.
3. Name it Silktide, paste the address as the MCP server URL, and select **Continue**.
4. Sign in to Silktide, choose an account, and select **Allow**. If Claude does not ask, select **Connect** beside Silktide first.
5. In a conversation, turn on Silktide in the tools menu and ask Claude to use it.

On Team and Enterprise plans, an owner adds the connector first, under **Organization settings**, then **Connectors**. Everyone then connects it from **Settings**, then **Connectors**.

## ChatGPT

In the desktop app:

1. Select your picture in the bottom corner, then **Settings**, then **Plugins**.
2. Select **Add**, then **Add MCP server**.
3. Name it Silktide, choose **Streamable HTTP**, and paste the address as the URL. Leave everything else blank and save it.
4. If ChatGPT shows **Authenticate** beside Silktide, select it. Sign in to Silktide, choose an account, and select **Allow**.
5. In a chat, type `/mcp` to check Silktide is connected, then ask ChatGPT to use it.

On chatgpt.com:

1. Select your picture in the bottom corner, then **Settings**, then **Plugins**.
2. Select **Browse directory**, then **Add**, then **Create custom MCP server**.
3. Name it Silktide and paste the address under **Connection**. Leave **Authentication** set to OAuth.
4. Tick **I understand and want to continue**, then select **Create as a plugin**. Sign in to Silktide, choose an account, and select **Allow**.
5. In a new chat, add Silktide from the tools menu.

On Business and Enterprise plans, a workspace admin may need to allow custom MCP servers first.

## Cursor

The quickest way is the **Add to Cursor** button under **Settings**, then **MCP** in Silktide. Cursor then asks you to sign in.

To set it up yourself:

1. Add Silktide to `~/.cursor/mcp.json`, with your region's address:

   ```json
   {
     "mcpServers": {
       "silktide": {
         "url": "https://mcp.eu.silktide.com/mcp"
       }
     }
   }
   ```

2. Cursor lists Silktide as needing sign-in. Select it, sign in to Silktide, choose an account, and select **Allow**.

## Other clients

Any client that supports remote MCP servers with OAuth can connect. Paste the address where it asks for an MCP server, then sign in. From the command line:

```bash
# Claude Code
claude mcp add --transport http silktide https://mcp.eu.silktide.com/mcp

# Codex
codex mcp add silktide --url https://mcp.eu.silktide.com/mcp
```

## Asking and changing

A connected client starts out only able to read. It can change things, such as creating a task or starting a test, only when both of these are true:

- An account admin has turned on **Agent edit actions** on the AI screen in Silktide's settings.
- Your role allows AI edit mode.

These are the same switches that let the Silktide Agent make changes; see [Agent controls](https://docs.silktide.com/ai/controls). Most clients also ask you to confirm before they call anything that changes your account.

## Who can connect

You need permission to use AI, and the account has to allow AI. These are checked on every request, so if either is taken away, a client that is already connected stops working on its next request.

The conversation runs on the client's own AI, so the AI providers chosen in Silktide's AI settings do not apply to it. When the client asks Silktide to do something that uses Silktide's own AI, that work uses only the providers your account allows.

## Limits

Requests that start paid work, such as tests, fetching or screenshotting a web page, and running a search, count toward your account's plan as they do in Silktide. Together, every client connected to an account can start 30 of them a minute and 300 an hour. Past that, the client is told to wait a few minutes and try again. Reading what Silktide already holds does not count toward this limit.

## What it can never reach

- **Only what you can see.** A client acts as you, in the account you chose, with your permissions.
- **Only what the account has.** Apps and features the account does not have are not offered.
- **No staff features.** Silktide's internal tools are never offered to a connected client, whoever signs in.

## When to use the API instead

MCP is for a person working with an AI client. For code that runs on its own, such as a nightly sync or a dashboard, use the REST API with an API key: start with the [Quickstart](https://developers.silktide.com/guides/quickstart.md). If you write that code with a coding agent, see [Build with a coding agent](https://developers.silktide.com/guides/build-with-a-coding-agent.md).
