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

# Devin MCP

> 外部の AI ツールがセッション、プレイブック、Knowledge、リポジトリのドキュメントを管理できるよう、公式 Devin MCP サーバーをセットアップします。

Devin MCP サーバーは、公開リポジトリと非公開リポジトリの両方について、Devin のプラットフォーム機能へのプログラムによるアクセスを提供します。リポジトリのドキュメントや検索にとどまらず、MCP 対応のあらゆる AI エージェントや IDE から、セッション管理、プレイブック、Knowledge、スケジュール設定に完全にアクセスできます。

> [!NOTE]
>
> あらゆる Devin セッションまたは MCP 対応クライアントで、セッションを作成し、プレイブックや Knowledge を管理し、スケジュールを設定するなど、さまざまな操作を行えます。Devin でできることの詳細については、[Advanced Capabilities](https://docs.devin.ai/ja/work-with-devin/advanced-capabilities.md) を参照してください。

## MCP とは何ですか？

[Model Context Protocol](https://modelcontextprotocol.io/introduction) (MCP) は、AI アプリが MCP 対応のデータソースやツールに安全に接続できるようにするオープン標準です。MCP は AI アプリケーションにとっての USB-C ポートのようなもので、AI アプリをさまざまなサービスに接続するための標準化された方法だと考えることができます。

## Devin MCP サーバー

Devin MCP サーバーは、公開および非公開リポジトリの両方へアクセスでき、さらにプラットフォーム管理機能をフルに利用できる、認証が必要なサービスです。

**ベースサーバーの URL:** `https://mcp.devin.ai/`

### 認証が必要です

Devin MCP サーバーを利用するには、Devin APIキーが必要です。

1. [Devin.ai](https://devin.ai/) でDevinアカウントを作成します
2. [アカウント設定](https://docs.devin.ai/ja/api-reference/authentication.md)でAPIキーを生成します
3. MCPクライアントの設定にAPIキーを含めます

MCP サーバーは、[Devin API](https://docs.devin.ai/ja/api-reference/authentication.md)と同じ認証方式をサポートしています。

| トークンタイプ | プレフィックス | org の解決 |
| - | - | - |
| **組織スコープのサービスユーザーキー** | `cog_` | 自動 — org\_id はサービスユーザーから特定されます |
| **Enterprise サービスユーザーキー** | `cog_` | `X-Org-Id` ヘッダーが必要です (以下を参照) |
| **パーソナルアクセストークン** | `cog_` | `X-Org-Id` ヘッダーが必要です (以下を参照) |

> [!NOTE]
>
> レガシーAPIキー (`apk_` / `apk_user_` プレフィックス) は、リポジトリのドキュメント用ツール (`read_wiki_structure`、`read_wiki_contents`、`ask_wiki_question`、`list_wiki_repos`) でのみ使用できます。セッション、プレイブック、Knowledge、スケジュール、統合の各ツールでは、レガシーAPIキーから組織を特定できないため、リクエストは拒否されます。これらのツールには[サービスユーザーAPIキー](https://docs.devin.ai/ja/api-reference/authentication.md#service-users-recommended-for-automation)を利用してください。

#### Enterprise アカウント: `X-Org-Id` ヘッダー

Enterprise サービスユーザーキーと PAT は、特定の組織ではなく、アカウントレベルでスコープされています。MCP ツールは組織レベルのリソース (セッション、プレイブック、Knowledge など) を扱うため、`X-Org-Id` ヘッダーを渡して、対象とする組織をサーバーに指定する必要があります。

```json theme={null}
{
  "mcpServers": {
    "devin": {
      "serverUrl": "https://mcp.devin.ai/mcp",
      "headers": {
        "Authorization": "Bearer <API_KEY>",
        "X-Org-Id": "<YOUR_ORG_ID>"
      }
    }
  }
}
```

> [!TIP]
>
> 組織IDは、**Settings > Devin API** ページの上部で確認できます。

組織スコープのサービスユーザーキーでは、このヘッダーは不要です。組織は自動的に特定されます。

## 利用可能なツール

### リポジトリのドキュメント

これらのツールを使用すると、任意の GitHub リポジトリのドキュメントを参照したりクエリしたりできます (公開リポジトリ、または認証が必要な非公開リポジトリに対応) :

| ツール | 説明 |
| - | - |
| **`read_wiki_structure`** | GitHub リポジトリのドキュメントトピックの一覧を取得します |
| **`read_wiki_contents`** | GitHub リポジトリに関するドキュメント全体を閲覧します |
| **`ask_question`** | 1 つ以上のリポジトリ (最大 10 件) について任意の質問を行い、AI によるコンテキストに基づいた回答を取得します |
| **`list_available_repos`** | Devin アカウントでクエリ可能なすべてのリポジトリを一覧表示します |

### セッション管理

Devin セッションをプログラムから作成、検索、確認、制御できます。

| ツール | 説明 |
| - | - |
| **`devin_session_create`** | 1 つ以上の Devin セッションを作成します。各セッションには、prompt、タイトル、プレイブック、タグ、ACU limit を設定できます |
| **`devin_session_search`** | タグ、プレイブック、origin、スケジュール、ユーザー、または作成時刻／更新時刻でセッションを検索および絞り込みできます |
| **`devin_session_interact`** | セッションを操作します — ステータスの取得、メッセージの送信、スリープ、終了、アーカイブ、メッセージや添付ファイルの読み取り、タグの管理を行えます |
| **`devin_session_events`** | セッション内のイベントを確認します — 要約の一覧表示、イベント詳細の完全版の取得、またはテキストによるイベント内容の検索を行えます |
| **`devin_session_gather`** | 複数のセッションが確定状態 (完了、エラー、スリープ、または待機中) に達するまで待機してから戻ります。ループでポーリングする代わりに、並列セッションを作成した後に利用すると便利です |

### プレイブック管理

Devin によるタスクの実行方法を標準化するプレイブックを作成・管理します。

| Tool | Description |
| - | - |
| **`devin_playbook_manage`** | プレイブックの一覧表示、GET、作成、更新、削除を行います。自動化マクロ (例: `!my_macro`) に対応しています |

### Knowledge 管理

Devinがコンテキストとして利用する組織の知識ベースを管理します。

| ツール | 説明 |
| - | - |
| **`devin_knowledge_manage`** | knowledge notes に対する完全なCRUD — 一覧表示、GET、作成、更新、削除、フォルダ構造の参照。さらに、knowledge suggestions も管理 — 一覧表示、閲覧、保留中の提案の却下。repo、フォルダ、検索クエリによる絞り込みをサポート |

### スケジュール管理

定期実行または 1 回限りの Devin セッションをスケジュール設定します。

| ツール | 説明 |
| - | - |
| **`devin_schedule_manage`** | スケジュールの一覧表示、GET、作成、更新、削除を行います。定期スケジュール向けのcron式、1 回限りのスケジュール、通知設定、Agent の選択をサポートします |

### 統合の管理

組織のネイティブ統合と MCP サーバーを閲覧・管理します。

| ツール | 説明 |
| - | - |
| **`devin_list_integrations`** | すべてのネイティブ統合 (例: GitHub、Jira、Slack) と MCP サーバーを、インストール状況および設定 URL とともに一覧表示します。インストール済み、未インストール、またはすべてで絞り込めます (レガシー名の `list_integrations` も引き続き利用できます) 。 |

## ワイヤプロトコル

Devin MCP サーバーは Streamable HTTP をサポートしています:

* **URL:** `https://mcp.devin.ai/mcp`
* HTTP 互換クライアントで動作します
* **すべての統合での利用を推奨します**

> [!NOTE]
>
> レガシー SSE (`/sse`) エンドポイントは非推奨になりました。代わりに `/mcp` エンドポイントを使用してください。

## DeepWiki MCP との主な違い

| 機能 | DeepWiki MCP | Devin MCP |
| - | - | - |
| **認証** | 不要 | API キーが必要 |
| **リポジトリへのアクセス** | 公開リポジトリのみ | 公開および非公開リポジトリ |
| **プラットフォーム管理** | 利用不可 | セッション、プレイブック、Knowledge、スケジュール、統合 |
| **ベース URL** | `https://mcp.deepwiki.com/` | `https://mcp.devin.ai/` |
| **料金** | 無料 | Devin アカウントが必要 |

## セットアップ手順

サーバー URL のフィールド名はクライアントによって異なります。Devin Desktop では `serverUrl` と `url` のどちらも使用できますが、他のほとんどのクライアントでは標準的な `url` フィールドのみを受け付けます。クライアントが認識しないフィールド名を使うと、MCP サーバー は何の通知もなく無視されます。

### Devin Desktop の場合:

```json theme={null}
{
  "mcpServers": {
    "devin": {
      "serverUrl": "https://mcp.devin.ai/mcp",
      "headers": {
        "Authorization": "Bearer <API_KEY>"
      }
    }
  }
}
```

### その他のほとんどのクライアント (例：Cursor) の場合:

```json theme={null}
{
  "mcpServers": {
    "devin": {
      "url": "https://mcp.devin.ai/mcp",
      "headers": {
        "Authorization": "Bearer <API_KEY>"
      }
    }
  }
}
```

### Claude Code の場合:

```bash theme={null}
claude mcp add -s user -t http devin https://mcp.devin.ai/mcp -H "Authorization: Bearer <API_KEY>"
```

## 関連リソース

* **[Advanced Capabilities](https://docs.devin.ai/ja/work-with-devin/advanced-capabilities.md)** — Devin の高度な機能の概要
* **[Devin の MCP Marketplace](https://docs.devin.ai/ja/work-with-devin/mcp.md)**
* **[リモート MCP サーバーを Claude に接続する方法](https://support.anthropic.com/en/articles/11175166-about-custom-integrations-using-remote-mcp)**
* **[MCP サーバーの利用方法に関する OpenAI のドキュメント](https://platform.openai.com/docs/guides/tools-remote-mcp)**
* **[DeepWiki MCP](https://docs.devin.ai/ja/work-with-devin/deepwiki-mcp.md)** — 公開リポジトリ向け
* **[DeepWiki](https://docs.devin.ai/ja/work-with-devin/deepwiki.md)**
* **[Ask Devin](https://docs.devin.ai/ja/work-with-devin/ask-devin.md)**


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