# Connect your AI tools with MCP

Source: https://docs.sliplane.io/mcp/getting-started

Connect AI coding tools to Sliplane with MCP using OAuth or an API key.

Connect your AI coding tools to Sliplane using the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/). The Sliplane MCP server is a hosted, remote MCP server available at:

```
https://mcp.sliplane.io
```

> **error**
>
> MCP tools can change or delete resources. Review infrastructure changes before approving them in your client.

## What is the Sliplane MCP server?

The MCP server lets AI clients use the [Sliplane API](https://ctrl.sliplane.io) through Streamable HTTP.

## Authentication

OAuth is the recommended authentication method. When your MCP client connects, it opens Sliplane in your browser so you can sign in and authorize access.

Use these OAuth settings if your client asks for them:

* **Client ID**: `sliplane-mcp`
* **Scope**: `full`
* **Client secret**: None

For clients without OAuth support, use a team [API key](/teams/api-keys). Keep it out of committed configuration files.

## Setup

Choose your MCP client below. The hosted server requires no local installation or self-hosting.

### Claude Code

**OAuth**

Add the Sliplane MCP server with its OAuth client ID:

```bash
claude mcp add --transport http \
  --client-id sliplane-mcp \
  sliplane https://mcp.sliplane.io
```

Start Claude Code, enter `/mcp`, and complete the browser authorization flow.

**API key**

Create an [API key](/teams/api-keys), then send it as a bearer token:

```bash
claude mcp add --transport http \
  -H "Authorization: Bearer yourapikeyhere" \
  sliplane https://mcp.sliplane.io
```

### Codex

**OAuth**

Add the Sliplane MCP server with OAuth:

```bash
codex mcp add sliplane \
  --url https://mcp.sliplane.io \
  --oauth-client-id sliplane-mcp
```

If authorization does not start automatically, run `codex mcp login sliplane --scopes full` and complete the browser flow. Use a current Codex release that supports `--oauth-client-id`.

**API key**

Create an [API key](/teams/api-keys), then send it as `--bearer-token-env-var`:

```bash
# Set SLIPLANE_API_KEY privately in the client environment first.
codex mcp add sliplane \
  --url https://mcp.sliplane.io \
  --bearer-token-env-var SLIPLANE_API_KEY
```

### Cursor

Add one of the following configurations to your project-specific or global `.cursor/mcp.json` file:

**OAuth**

```json title=".cursor/mcp.json"
{
  "mcpServers": {
    "sliplane": {
      "url": "https://mcp.sliplane.io",
      "auth": {
        "CLIENT_ID": "sliplane-mcp",
        "scopes": ["full"]
      }
    }
  }
}
```

When Cursor connects, complete the OAuth authorization flow.

**API key**

```json title=".cursor/mcp.json"
{
  "mcpServers": {
    "sliplane": {
      "url": "https://mcp.sliplane.io",
      "headers": {
        "Authorization": "Bearer yourapikeyhere"
      }
    }
  }
}
```

### opencode

**OAuth**

Merge this into your existing configuration:

```json title="opencode.json"
{
  "mcp": {
    "sliplane": {
      "type": "remote",
      "url": "https://mcp.sliplane.io",
      "oauth": {
        "clientId": "sliplane-mcp",
        "scope": "full"
      }
    }
  }
}
```

Run `opencode mcp auth sliplane` and complete browser authorization.

**API key**

Add this entry to your `opencode.json`:

```json title="opencode.json"
{
  "mcp": {
    "sliplane": {
      "type": "remote",
      "url": "https://mcp.sliplane.io",
      "oauth": false,
      "headers": {
        "Authorization": "Bearer {env:SLIPLANE_API_KEY}"
      }
    }
  }
}
```

Set `SLIPLANE_API_KEY` privately in the environment that launches opencode.

### Visual Studio Code

For an API-key connection, create `.vscode/mcp.json`. The password input keeps the key out of the configuration file:

```json title=".vscode/mcp.json"
{
  "inputs": [
    {
      "type": "promptString",
      "id": "sliplane-api-key",
      "description": "Sliplane API key",
      "password": true
    }
  ],
  "servers": {
    "sliplane": {
      "type": "http",
      "url": "https://mcp.sliplane.io",
      "headers": {
        "Authorization": "Bearer ${input:sliplane-api-key}"
      }
    }
  }
}
```

Start the server in VS Code's MCP controls and enter your key when prompted.

## Other MCP clients

For clients not listed above, use the following connection settings:

* **URL**: `https://mcp.sliplane.io`
* **Transport**: Streamable HTTP
* **OAuth client ID**: `sliplane-mcp`
* **OAuth scope**: `full`
* **OAuth client secret**: None

For API-key authentication, send an `Authorization: Bearer <API key>` header.

## Verify the connection

Ask your client to list your Sliplane projects to verify the connection.