MCP設定 - Devin Docs

MCPサーバーの追加

コマンドラインから

MCP サーバーを追加する最も簡単な方法:

# stdioサーバー — --の後にコマンドを渡す
devin mcp add <name> -- <command> [args...]

# HTTPサーバー — URLを位置引数として渡す
devin mcp add <name> <URL>

# HTTPサーバー — または--urlフラグを利用する
devin mcp add <name> --url <URL>

トランスポートの種類は自動的に推定されます。URL は HTTP (Streamable HTTP) を示し、末尾の引数 (または --command) は stdio を示します。

リモートの MCP サーバーはデフォルトで Streamable HTTP を利用します。サーバーが HTTP 4xx エラーを返した場合、CLI は同じ URL で SSE にフォールバックします。必要に応じて "transport": "sse" を明示的に設定してください — 詳しくは下記のレガシー SSE フォールバックを参照してください。

デフォルトでは、サーバーは local スコープ (.devin/config.local.json、gitignored) に保存されます。変更するには -s/--scope を利用してください:

devin mcp add -s project <name> <URL>   # .devin/config.json で共有
devin mcp add -s user <name> <URL>      # グローバル (~/.config/devin/config.json; Windows では %APPDATA%\devin\config.json)

コマンドラインからもサーバーを管理できます：

devin mcp list              # List all configured servers
devin mcp get <name>        # Show details for a specific server
devin mcp remove <name>     # Remove a configured server
devin mcp login <name>      # Authenticate with a server via OAuth
devin mcp logout <name>     # Remove stored OAuth credentials
devin mcp enable <name>     # 無効化されたサーバーを有効化する
devin mcp disable <name>    # サーバーを削除せずに無効化する

設定ファイルを使う

サーバーを設定ファイルの mcpServers セクションに直接追加します。

プロジェクト設定
ユーザー設定
ローカル上書き

// .devin/config.json
{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "@company/mcp-server"],
      "env": {
        "API_KEY": "your-key"
      }
    }
  }
}

プロジェクトレベルのサーバーは、バージョン管理を通じてチームで共有されます。

// ~/.config/devin/config.json
{
  "mcpServers": {
    "my-server": {
      "command": "node",
      "args": ["/path/to/my-server.js"],
      "env": {}
    }
  }
}

ユーザーレベルのサーバーは、すべてのプロジェクトに適用されます。

// .devin/config.local.json
{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "@company/mcp-server"],
      "env": {
        "API_KEY": "my-personal-key"
      }
    }
  }
}

ローカル設定は gitignore の対象になるため、個人用のAPIキーにはこちらを利用してください。

サーバーの設定オプション

MCPサーバーは、ローカルコマンド (stdio トランスポート) またはリモートサーバー (HTTP トランスポート) のいずれかの方法で設定できます。

ローカルコマンド (stdio)

フィールド	型	必須	説明
`command`	string	はい	実行する実行ファイル
`args`	string[]	いいえ	コマンドライン引数
`env`	object	いいえ	設定する環境変数
`disabled`	boolean	いいえ	`true` に設定すると、このサーバーをスキップします (サーバーの有効化と無効化を参照)

リモートサーバー (Streamable HTTP)

Field	Type	Required	Description
`url`	string	Yes	MCPサーバーのエンドポイント URL
`transport`	string	No	`"http"` (Streamable HTTP。URL ベースのサーバーのデフォルト) または `"sse"` (レガシー SSE) 。`"http"` に設定するか省略すると、CLI はまず Streamable HTTP を試し、4xx エラーが発生した場合は SSE にフォールバックします (spec に従って) 。サーバーの SSE エンドポイントが別のパスにある場合は、`"sse"` を明示的に設定してください。
`headers`	object	No	リクエストに含めるカスタム HTTP ヘッダー
`oauthClientId`	string	No	動的クライアント登録 (DCR) をサポートしていないサーバー向けの事前登録済み OAuth クライアントID (例: GitHub) 。以下の「事前登録済み OAuth クライアント」セクションを参照してください。
`oauthClientSecret`	string	No	機密クライアント向けの OAuth クライアントシークレット。`oauthClientId` と組み合わせて使用します。
`oauthResource`	string	No	OAuth リクエストで送信する RFC 8707 の `resource` パラメータをオーバーライドします (デフォルト: MCP サーバー URL) 。このパラメータを受け付けない provider の場合は、完全に省略するために空文字列 (`""`) に設定してください。OAuth リソースのオーバーライドを参照してください。
`disabled`	boolean	No	このサーバーをスキップするには `true` に設定します (サーバーの有効化と無効化を参照)

使用例

GitHub (stdio)

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_..."
      }
    }
  }
}

Notion (HTTP with OAuth)

{
  "mcpServers": {
    "notion": {
      "url": "https://mcp.notion.com/mcp",
      "transport": "http"
    }
  }
}

OAuth ベースのサーバーを追加したら、devin mcp login notion を実行して認証します。詳細は下記の認証をご覧ください。

Linear (HTTP with OAuth)

{
  "mcpServers": {
    "linear": {
      "url": "https://mcp.linear.app/mcp",
      "transport": "http"
    }
  }
}

Atlassian / Jira (HTTP with OAuth)

{
  "mcpServers": {
    "atlassian": {
      "url": "https://mcp.atlassian.com/v1/mcp",
      "transport": "http"
    }
  }
}

追加後、devin mcp login atlassian を実行して認証します。各 MCP クライアント (Windsurf、Claude Code、Devin CLI) はそれぞれ独自の OAuth セッションを保持するため、別のツールですでに認証済みでも、個別にログインする必要があります。

カスタムサーバー (stdio)

{
  "mcpServers": {
    "my-tools": {
      "command": "python",
      "args": ["./scripts/mcp-server.py"],
      "env": {
        "DB_URL": "postgres://localhost/mydb"
      }
    }
  }
}

認証

一部のリモートMCPサーバーでは、OAuth認証が必要です。OAuth対応のサーバーを設定に追加したら、login コマンドを使って認証してください。

devin mcp login <server-name>

たとえば、

devin mcp login notion    # Notionで認証する
devin mcp login linear    # Linearで認証する

アクセスを承認するためのブラウザウィンドウが開きます。OAuthトークンはローカルに保存され、自動的に更新されます。必要に応じて、特定のOAuthスコープをリクエストすることもできます：

devin mcp login notion --scopes read,write

サーバーに保存済みのOAuth認証情報を削除するには:

devin mcp logout <server-name>

サーバーがOAuthに対応している場合は、そのサーバーを初めて利用する際にも、自動的に認証を求められます。

事前登録済みのOAuthクライアント

OAuthベースのMCPサーバーのほとんどは動的クライアント登録 (DCR) をサポートしているため、Devin CLIが自動的に自身を登録し、クライアント認証情報を指定する必要はありません。一部のプロバイダー (例: GitHub) はDCRをサポートしておらず、代わりに事前登録済みのOAuthクライアントが必要です。その場合は、oauthClientId / oauthClientSecret を使用して、クライアントIDと、機密クライアントの場合はクライアントシークレットを指定します。

{
  "mcpServers": {
    "my-server": {
      "url": "https://mcp.example.com/mcp",
      "transport": "http",
      "oauthClientId": "Iv1.abc123def456",
      "oauthClientSecret": "${env:MY_MCP_CLIENT_SECRET}"
    }
  }
}

oauthClientId が設定されている場合、Devin CLI は動的クライアント登録をスキップし、OAuthフローでは事前登録済みのクライアントを利用します。通常どおり認証するには、devin mcp login <name> を実行するか、初回利用時にトリガーしてください。サーバーの追加時やログイン時に、これらをコマンドラインから設定することもできます：

devin mcp add my-server <URL> --oauth-client-id <ID> --oauth-client-secret <SECRET>
devin mcp login my-server --oauth-client-id <ID> --oauth-client-secret <SECRET>

oauthClientId / oauthClientSecret は、認可フローで使用される OAuth クライアントの認証情報です。これらは汎用的なリクエスト単位の認証情報ではありません。サーバーが固定のトークンを想定している場合は、代わりに headers (HTTP) または env (stdio) を利用してください。

クライアントシークレットを共有設定にコミットしないでください。environment variable (${env:VAR}) から参照するか、ファイル (${file:/path}) から読み取るか、.devin/config.local.json (gitignore の対象) に保存してください。詳しくは以下の「シークレットの管理」セクションを参照してください。

OAuth リソースのオーバーライド

OAuth の認可およびトークン交換時に、Devin CLI は認可サーバーが対象オーディエンスに制限されたトークンを発行できるよう、RFC 8707 の resource パラメータを送信します。デフォルトでは、この値は MCP server の URL です。oauthResource で上書きできます:

{
  "mcpServers": {
    "my-server": {
      "url": "https://my-server.example.com/mcp",
      "transport": "http",
      "oauthResource": ""
    }
  }
}

このフィールドには、3つの動作があります。

未設定 (デフォルト) : resource を MCP server URL に設定して送信します。
空でない値: デフォルト値を指定した値で置き換えます (例: 特定の application ID URI) 。
空文字列 (""): 認可 URL とトークン交換の両方から resource パラメータを完全に省略します。

server の追加時やログイン時には、コマンドラインから設定することもできます:

devin mcp add my-server <URL> --oauth-resource ""
devin mcp login my-server --oauth-resource ""

他のOAuthフィールドと同様に、oauthResource は ${env:VAR} と ${file:/path} の展開に対応しています。

サーバーの有効化と無効化

設定を削除せずに、MCPサーバーを一時的に無効にできます。無効にしたサーバーはツールの検出時にスキップされるため、そのツールは表示されず、サーバープロセスも起動されません。

devin mcp disable <name>    # サーバーを無効化する
devin mcp enable <name>     # 再度有効化する

これにより、設定ファイル内のサーバーエントリに "disabled": true フラグが設定されます。特定のスコープを対象にするには、-s/--scope を利用します。

devin mcp disable -s project my-server
devin mcp enable -s user my-server

このフラグは、設定ファイルに直接指定することもできます。

{
  "mcpServers": {
    "my-server": {
      "command": "npx",
      "args": ["-y", "@company/mcp-server"],
      "disabled": true
    }
  }
}

無効化は、サーバーの設定 (環境変数やOAuth認証情報を含む) を保持したまま、一時的に使用を停止したい場合に便利です。たとえば、起動時間を短縮したり、問題を切り分けたりするためです。

シークレットの管理

APIキーやシークレットをバージョン管理にコミットしないでください。機密性の高い値には .devin/config.local.json を利用してください。

チームでのプロジェクトでは、次のパターンを推奨します。

.devin/config.json で、env var はプレースホルダーにするか未設定のままサーバーを定義する
各チームメンバーが .devin/config.local.json に個人用のキーを追加する

ローカル設定ファイルは自動的に git の対象外になります。

MCPの権限

権限設定で、特定のMCPツールを事前承認したり、拒否したり、都度確認を必須にしたりできます。

{
  "permissions": {
    "allow": [
      "mcp__github__list_issues",
      "mcp__github__create_issue"
    ],
    "deny": [
      "mcp__github__delete_repo"
    ],
    "ask": [
      "mcp__linear__*"
    ]
  }
}

権限マッチャーのパターン:

パターン	一致対象
`mcp__server__tool`	特定のサーバー上の特定のツール
`mcp__server__*`	特定のサーバー上のすべてのツール
`mcp__*`	すべてのサーバー上のすべてのMCPツール

組織の制限

Enterprise チームをご利用の場合、接続できる MCPサーバーを管理者が制限していることがあります。設定済みのサーバーでも、チームで MCP が無効になっている場合や、チームの許可リスト、または必須の MCP レジストリ に含まれていない場合は、ブロックされることがあります。その場合、そのサーバーには接続できず、ツールも利用できません。詳しくは、チーム設定 — MCP レジストリを参照してください。

トラブルシューティング

リモートサーバーで認証が必要 / OAuth エラーが発生する

リモート MCP サーバーへの接続時に Auth required や AuthRequired のようなエラーが表示される場合、そのサーバーでは OAuth 認証が必要です。実行:

devin mcp login <server-name>

MCP クライアントごとに認証は個別に行われます。Windsurf や Claude Code ですでに認証済みでも、Devin CLI では別途 devin mcp login を実行する必要があります。認証状態を確認するには、認証情報をいったん削除してから再度追加してみてください:

devin mcp logout <server-name>
devin mcp login <server-name>

サーバーが起動しない

Devin CLI の外部でコマンドが動作することを確認してください:

npx -y @modelcontextprotocol/server-github

必要な環境変数がすべて設定されていることを確認してください。

ツールが表示されない

エージェントに MCP サーバーとツールを一覧表示するよう依頼してください。サーバーの初期化に少し時間がかかる場合があります。

Permission denied

権限設定を確認してください。MCP ツールはデフォルトで承認を求めるようになっています。自動承認するには permissions.allow に追加してください。

resource パラメータが原因の OAuth エラー

一部の認可サーバーは、RFC 8707 の resource パラメータを含む OAuth リクエストを拒否します。パラメータを省略するには、oauthResource を空文字列に設定してください:

{
  "mcpServers": {
    "my-server": {
      "url": "https://my-server.example.com/mcp",
      "oauthResource": ""
    }
  }
}

その後、再認証してください:

devin mcp logout my-server
devin mcp login my-server

oauthResource の動作の詳細については、OAuth リソースのオーバーライドを参照してください。

レガシー SSE フォールバック

HTTP サーバーに接続すると、Devin CLI はまず Streamable HTTP を試します。サーバーが HTTP 4xx エラー (例: 404 または 405) を返した場合、自動的に同じ設定済み URLで レガシー SSE にフォールバックします。これは MCP spec の後方互換性ガイダンスに従った動作です。このフォールバックがトリガーされるのは 4xx レスポンスの場合のみです。接続エラー、タイムアウト、5xx レスポンスでは SSE を試行せず、そのままエラーとして報告されます。サーバーの SSE エンドポイントが別のパス (例: /mcp ではなく /sse) にある場合は、SSE URL とともに "transport": "sse" を設定すると、Streamable HTTP を試さずに直接接続できます。両方のトランスポートが失敗した場合、トラブルシューティングに役立つよう、エラーメッセージには両方の試行の詳細が含まれます。

​MCPサーバーの追加

​コマンドラインから

​設定ファイルを使う

​サーバーの設定オプション

​ローカルコマンド (stdio)

​リモートサーバー (Streamable HTTP)

​使用例

​認証

​事前登録済みのOAuthクライアント

​OAuth リソースのオーバーライド

​サーバーの有効化と無効化

​シークレットの管理

​MCPの権限

​組織の制限

​トラブルシューティング

MCPサーバーの追加

コマンドラインから

設定ファイルを使う

サーバーの設定オプション

ローカルコマンド (stdio)

リモートサーバー (Streamable HTTP)

使用例

認証

事前登録済みのOAuthクライアント

OAuth リソースのオーバーライド

サーバーの有効化と無効化

シークレットの管理

MCPの権限

組織の制限

トラブルシューティング