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

# Devin のプラグイン MCP サーバー

> Devin プラグインで MCP サーバーを宣言し、認証情報を誰が保持するか（各メンバー、組織のサービスアカウント、またはエンタープライズ）を決定します。

プラグインには MCP サーバー (例えば issue トラッカーなど) を含めることができます。これにより、プラグインをインストールしたすべてのユーザーが、一から設定しなくても同じサーバー設定を利用できます。インストール後に、APIキーや OAuth サインインなど、サーバーに必要な認証情報を指定します。接続が個人用になるか共有になるかは、プラグインのインストール先と、インストールの **アクセス** 設定によって決まります。

## 宣言

サーバーは、ルートにある `.mcp.json` で `mcpServers` マップとして宣言します。マニフェストのインライン `mcpServers` フィールドには、このラッパーを省いた同じマップを指定します。

```json theme={null}
{
  "mcpServers": {
    "example-mcp": {
      "url": "https://mcp.example.com/mcp",
      "tokenScope": "user"
    },
    "example-mcp-service-account": {
      "url": "https://mcp.example.com/mcp",
      "headers": {
        "Authorization": "Bearer ${EXAMPLE_MCP_SERVICE_ACCOUNT_TOKEN}"
      }
    }
  }
}
```

| フィールド | 型 | 説明 |
| - | - | - |
| `url` | string | サーバーのエンドポイント。必須。 |
| `transport` | string | 従来のSSE エンドポイントの場合は `"sse"` を設定します。Streamable HTTP の場合は省略します。 |
| `headers` | object | すべてのリクエストで送信される HTTP ヘッダー。値にはプレースホルダーを含めることができます。 |
| `oauthClientId` | string | 動的クライアント登録に対応していないプロバイダー向けの、事前登録済みの OAuthクライアント。これを設定すると、ヘッダーの内容にかかわらず、そのサーバーは OAuth サーバーとして扱われます。 |
| `oauthClientSecret` | string | プラグインでは指定できません (指定すると宣言が拒否されます) 。シークレットは、インストールする管理者がサーバーの設定で入力します。 |
| `oauthScopes` | string\[] | リクエストするスコープ。`oauthClientId` が必要です。 |
| `oauthResource` | string | RFC 8707 の `resource` パラメーターを上書きします (デフォルト: サーバー URL) 。`""` を指定すると省略されます。それ以外の値は、このサーバーを識別するものである必要があります。 |
| `tokenScope` | string | OAuth サーバーを組織またはエンタープライズ単位でインストールした場合のデフォルトの **アクセス**: `"user"` (各メンバーがサインイン) または `"org"` (1 つの共有接続) 。未設定の場合は marketplace 項目のスコープが適用され、それもなければ共有接続になります。宣言した値は、プラグインが再調整されるたびに再適用されます。個人インストールの場合は、常にメンバー自身の接続になります。 |
| `disabled` | boolean | `true` にするとサーバーをスキップします。 |
| `disabledTools` | string\[] | このサーバーで Devin に対して非表示にするツール名。 |
| `description` | string | Customize でサーバーとともに表示されます。 |

**プレースホルダー。** `url` または `headers` 内の `${NAME}` には、インストールするユーザーがサーバーの Connect シートで値を入力します。`${NAME:-default}` は、値が保存されていない場合のフォールバックを指定します。プラグインのサーバーが読み取るのはそのインストールに保存された値のみで、同名の[セッションシークレット](https://docs.devinenterprise.com/ja/product-guides/secrets.md)は参照しません。宣言には実際のトークンを絶対に記述しないでください。記述した内容がそのまま保存されます。

代わりに、サーバーでローカルコマンド (`command`、`args`、`env`) を run することもできます。その場合、上記の HTTP 認証情報フィールドは使用できません。

> [!NOTE]
>
> スタンドアロンサーバー用の Customize フォームについては、[MCPサーバー](https://docs.devinenterprise.com/ja/work-with-devin/mcp.md#configuration-format)ページを参照してください。プラグインのサーバーでは上記のフィールド名を使用し、URL、トランスポート、ヘッダーはインストール済みの行に read-only で表示されます。

## 認証情報の保持者

| インストールした主体 | 認証情報の所有者 | 接続するユーザー |
| - | - | - |
| メンバー (個人スコープ) | そのメンバー | メンバー本人 (Customize → MCPs から) |
| 組織 | 組織 (`Access: Organization`) または各メンバー (`Access: Personal`) | org 管理者、または各メンバー |
| エンタープライズ | エンタープライズ (`Access: Enterprise`) またはすべての組織の各メンバー (`Access: Personal`) | エンタープライズ管理者、または各メンバー |

## セットアップ

各セットアップは、上記の宣言にある項目のいずれか 1 つと、プラグインのインストール先および配布方法を組み合わせたものです。**必須** (Required) ではスコープ内の全員にインストールされ、**Offered** では各組織またはメンバーが任意でインストールできます。どちらも [Customize](https://docs.devinenterprise.com/ja/product-guides/plugins.md#mcps) でプラグインごとに設定します。

### 全員にユーザーごとの OAuth を適用する

OAuth をサポートするサーバーの場合は、`example-mcp` 項目を利用し、エンタープライズまたは組織でプラグインを **必須** としてインストールします。

`tokenScope: "user"` を指定するとアクセスのデフォルトが **個人** になるため、各メンバーは Customize → MCPs から、またはその MCP を必要とする最初のセッションで、一度だけサインインすれば済みます。

### 組織で 1 つのサービスアカウントを共有する

`example-mcp-service-account` 項目を利用し、組織にプラグインをインストールします。

* `Authorization` ヘッダーにはプレースホルダーが設定されているため、行には **Connect** と表示されます。トークンは org 管理者が入力し、メンバーには表示されません。
* サーバーがトークンを拒否した場合 (401)、行には **Check the credential** と表示されます。サーバーが OAuth にも対応している場合は、**Sign in with OAuth instead** も表示されます。
* OAuth でサインインするサービスアカウントの場合は、ヘッダーを削除して `tokenScope: "org"` を設定し、そのアカウントのログインを接続します。

### 組織ごとに1つのキーを使用

`example-mcp-service-account` 項目をエンタープライズプラグインに追加し、**Offered to organizations** に設定します。

* インストールは、それを行った各組織が所有します。そのため、各組織の管理者が `${EXAMPLE_MCP_SERVICE_ACCOUNT_TOKEN}` に自組織のキーを入力します。
* エンタープライズ側では何も接続されず、どの組織も他の組織のキーを参照できません。
* 一方、**必須** のエンタープライズプラグインの場合は、エンタープライズが所有するインストールが1つだけ作成され、すべての組織で1つのキーを共有します。

### 1つのプラグインで両方を提供する

上記の宣言のように両方の項目を含めたうえで、プラグインを提供します。プラグインをインストールした各組織には2つの行が作成されます。1つはメンバーがサインインする行、もう1つは org 管理者が接続する行です。サーバー名を別々にしておけば、プラグインのスキル内で利用するサーバーを指定できます。


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