> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Devin

> Add Spiral to Devin as a custom MCP server, in Devin's web app or the Devin CLI: paste one link, sign in, no API key.

Devin's web app and the Devin CLI each keep their own Spiral connection. Set up the one you use; signing in on one
does not sign in the other.

## Devin (web app)

**1. Add a custom MCP**

Open [Customize › MCPs](https://app.devin.ai/customize?tab=mcps). Click **+** and choose **New MCP**. Fill in:

* **Server Name**: Spiral
* **Transport**: **HTTP**
* **Server URL**: `https://api.spiral.ai/mcp`
* **Authentication method**: **OAuth**
* **Access**: **Personal**, so each member signs in to their own Spiral account

Leave **OAuth credentials** empty: Devin registers itself with Spiral. Click **Add**.

**2. Sign in to Spiral and approve**

In **Customize › MCPs**, open Spiral and choose **Connect**. Spiral opens: sign in, pick the organization and click
**Authorize**. No API key.

**3. Check it**

On Spiral's configuration page, click **Test tools**. Devin lists Spiral's tools.

**4. Try a starter prompt**

Start a new session and send:

```text theme={null}
Find a text-to-image tool, tell me what one image costs, then generate a lighthouse at dawn.
```

Any member can add a server for themselves. To add Spiral for the whole organization, an admin switches **Myself** to
the organization and chooses **Add custom MCP**.

> [accordion] With an API key instead
>
> Create a key under **API keys** in the [console](https://spiral.ai/start). In the **New MCP** form, set
> **Authentication method** to **Auth Header**, keep the header key `Authorization` and set the value to
> `Bearer <your key>`.

## Devin CLI

The CLI's settings also apply to Devin Local, the default agent in new Devin Desktop tabs.

**1. Add the server**

```bash theme={null}
devin mcp add -s user spiral https://api.spiral.ai/mcp
```

`-s user` makes Spiral available in all your projects. Without it, the server goes to this project's
`.devin/mcp_config.local.json`.

**2. Sign in**

```bash theme={null}
devin mcp login spiral
```

Sign in to Spiral in the browser and click **Authorize**. No API key. `devin mcp logout spiral` signs out.

**3. Try a starter prompt**

Start `devin` and send:

```text theme={null}
Find a text-to-image tool, tell me what one image costs, then generate a lighthouse at dawn.
```

Devin asks before it uses each MCP tool. Approve the prompt, or add `mcp__spiral__*` to `permissions.allow`.

> [accordion] With an API key instead
>
> Create a key under **API keys** in the [console](https://spiral.ai/start) and add Spiral to
> `~/.config/devin/mcp_config.json` (`%APPDATA%\devin\mcp_config.json` on Windows) with the key as a header:
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "spiral": {
>       "url": "https://api.spiral.ai/mcp",
>       "transport": "http",
>       "headers": {
>         "Authorization": "Bearer <your key>"
>       }
>     }
>   }
> }
> ```
>
> Keep the key out of `.devin/mcp_config.json`: that file is shared through version control.

If something does not work, see [Troubleshooting](/docs/mcp-server.md#troubleshooting).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.