[アップデート] Amazon Q Developer CLI のリモート MCP サーバー構成でヘッダーが指定できるようになったので GitHub MCP サーバーに PAT で接続してみた
いわさです。
先日、Amazon Q Developer CLI でリモート MCP サーバーが使えるようになるというアップデートがありました。
この記事の中でリモート MCP サーバーをいくつか取り扱いましたが、GitHub リモート MCP サーバーへの接続に失敗していました。
GitHub リモート MCP サーバーでは OAuth 認証もしくは PAT を使った認証がサポートされているのですが、そのどちらもうまく接続できない状態でした。
あれから2日ほどですが、ちょうど今朝 Amazon Q Developer CLI の新しいバージョン v1.16.2 がリリースされました。
その更新内容を見てみると...
What's New in Amazon Q CLI
## 1.16.2 (2025-09-19)
• Add support for preToolUse and postToolUse hook - [#2875](https://github.com/aws/amazon-q-developer-cli/pull/2875)
• Support for specifying oauth scopes via config
• Support for headers ingestion for remote mcp
• Change autocomplete shortcut from ctrl-f to ctrl-g
• Fix file-path expansion in mcp-config
• Fix filepath expansion to use absolute paths
## 1.16.1 (2025-09-17)
• Dashboard not updating after logging in
Support for headers ingestion for remote mcp
ということで、リモート MCP サーバーを使う際にヘッダー取り込みできるようになったようです。
本日はこの機能と PAT を使って GitHub リモート MCP サーバーに接続できましたので、その様子を紹介します。
Personal Access Token (PAT) での接続ができた
生成手順は割愛しますが、GitHub 上で Settings -> Developer Settings から適当な PAT を作っておきました。
PAT の使い方ですが、次のドキュメントにも記載されていましてAuthorization
ヘッダーのベアラートークンとして指定します。
今回のアップデートでリモート MCP サーバー構成のheaders
が認証時に反映されるようになったようなので、次のように指定します。
{
"mcpServers": {
"awslabs.aws-documentation-mcp-server": {
"command": "uvx",
"timeout": 60000,
"args": [
"awslabs.aws-documentation-mcp-server@latest"
],
"env": {
"FASTMCP_LOG_LEVEL": "ERROR",
"AWS_DOCUMENTATION_PARTITION": "aws"
}
},
"MicrosoftLearn": {
"type": "http",
"url": "https://learn.microsoft.com/api/mcp"
},
"GitHub": {
"type": "http",
"url": "https://api.githubcopilot.com/mcp",
"headers": {
"Authorization": "Bearer github_pat_11A...fz5"
}
}
}
}
前回 v1.16.0 の時は上記を指定してもDynamic registration failed: Registration failed: HTTP 404 Not Found: 404 page not found
が発生してしまっていたのですが、今回はどうかな。
Amazon Q Developer CLI を起動してみましょう。
% q chat
✓ MicrosoftLearn loaded in 1.09 s
✓ awslabs.aws-documentation-mcp-server loaded in 2.23 s
✓ GitHub loaded in 2.52 s
⢠⣶⣶⣦⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢀⣤⣶⣿⣿⣿⣶⣦⡀⠀
⠀⠀⠀⣾⡿⢻⣿⡆⠀⠀⠀⢀⣄⡄⢀⣠⣤⣤⡀⢀⣠⣤⣤⡀⠀⠀⢀⣠⣤⣤⣤⣄⠀⠀⢀⣤⣤⣤⣤⣤⣤⡀⠀⠀⣀⣤⣤⣤⣀⠀⠀⠀⢠⣤⡀⣀⣤⣤⣄⡀⠀⠀⠀⠀⠀⠀⢠⣿⣿⠋⠀⠀⠀⠙⣿⣿⡆
⠀⠀⣼⣿⠇⠀⣿⣿⡄⠀⠀⢸⣿⣿⠛⠉⠻⣿⣿⠛⠉⠛⣿⣿⠀⠀⠘⠛⠉⠉⠻⣿⣧⠀⠈⠛⠛⠛⣻⣿⡿⠀⢀⣾⣿⠛⠉⠻⣿⣷⡀⠀⢸⣿⡟⠛⠉⢻⣿⣷⠀⠀⠀⠀⠀⠀⣼⣿⡏⠀⠀⠀⠀⠀⢸⣿⣿
⠀⢰⣿⣿⣤⣤⣼⣿⣷⠀⠀⢸⣿⣿⠀⠀⠀⣿⣿⠀⠀⠀⣿⣿⠀⠀⢀⣴⣶⣶⣶⣿⣿⠀⠀⠀⣠⣾⡿⠋⠀⠀⢸⣿⣿⠀⠀⠀⣿⣿⡇⠀⢸⣿⡇⠀⠀⢸⣿⣿⠀⠀⠀⠀⠀⠀⢹⣿⣇⠀⠀⠀⠀⠀⢸⣿⡿
⢀⣿⣿⠋⠉⠉⠉⢻⣿⣇⠀⢸⣿⣿⠀⠀⠀⣿⣿⠀⠀⠀⣿⣿⠀⠀⣿⣿⡀⠀⣠⣿⣿⠀⢀⣴⣿⣋⣀⣀⣀⡀⠘⣿⣿⣄⣀⣠⣿⣿⠃⠀⢸⣿⡇⠀⠀⢸⣿⣿⠀⠀⠀⠀⠀⠀⠈⢿⣿⣦⣀⣀⣀⣴⣿⡿⠃
⠚⠛⠋⠀⠀⠀⠀⠘⠛⠛⠀⠘⠛⠛⠀⠀⠀⠛⠛⠀⠀⠀⠛⠛⠀⠀⠙⠻⠿⠟⠋⠛⠛⠀⠘⠛⠛⠛⠛⠛⠛⠃⠀⠈⠛⠿⠿⠿⠛⠁⠀⠀⠘⠛⠃⠀⠀⠘⠛⠛⠀⠀⠀⠀⠀⠀⠀⠀⠙⠛⠿⢿⣿⣿⣋⠀⠀
⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠈⠛⠿⢿⡧
╭─────────────────────────────── Did you know? ────────────────────────────────╮
│ │
│ You can resume the last conversation from your current directory by │
│ launching with q chat --resume │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
/help all commands • ctrl + j new lines • ctrl + s fuzzy search
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🤖 You are chatting with claude-sonnet-4
>
なんと、起動時の MCP ローディングフェーズでエラーが発生しなくなりました。
これはうまくいっていそうだ。
GitHub を操作するような何かを指示してみましょう。
> GitHubのリポジトリ一覧を取得してください
> GitHubのリポジトリ一覧を取得します。まず、あなたのGitHubアカウント情報を確認してから、リポジトリを検索します。
🛠️ Using tool: get_me from mcp server GitHub
⋮
● Running get_me with the param:
⋮ {}
Allow this action? Use 't' to trust (always allow) this tool for the session. [y/n/t]:
おお、GitHub MCP サーバーを認識して使ってくれそうですね。
get_me
というツールで GitHub ユーザーの情報を取得してくれるみたいです。
> t
⋮
● Completed in 0.332s
> あなたのGitHubアカウント(Tak1wa)のリポジトリ一覧を取得します。
🛠️ Using tool: search_repositories from mcp server GitHub
⋮
● Running search_repositories with the param:
⋮ {
⋮ "query": "user:Tak1wa",
⋮ "perPage": 50
⋮ }
Allow this action? Use 't' to trust (always allow) this tool for the session. [y/n/t]:
> t
⋮
● Completed in 1.783s
> あなたのGitHubアカウント(Tak1wa)には合計121個のリポジトリがあります。以下が最初の50個のリポジトリ一覧です:
## 主要なリポジトリ(スター数順)
:
残りの71個のリポジトリも確認したい場合は、次のページを取得できます。
>
ユーザー情報が確認できたので、別のツールsearch_repositories
を使ってリポジトリ検索をしてくれました。
うまく動いていますね。
OAuth は引き続きうまくいかない
今回のアップデートでSupport for specifying oauth scopes via config
というものもあったので、PAT ではなく OAuth 認証も使えるのではと思いましたが、こちらはダメでした。
どうやらhttps://api.githubcopilot.com/authorized
を認可のエンドポイントとしてリクエスト送信しているのですが、そこが 404 になっているんですよね。
上記アップデートは次のプルリクエストのものでして OAuth のスコープフィールドを指定できるようになるというものです。
GitHub リモート MCP サーバーの場合は関係ないようなのですが、Amazon Q Developer CI はリモート MCP サーバーの認証時にデフォルトスコープが使われます。
一部の MCP プロバイダーは特定のスコープでエラーを出してしまうみたいで、そういったときにスコープを直接指定することが回避できるみたいですね。他の Issue では Datadog MCP Server などの場合はスコープを外すことで動作できるようになるという情報がありました。
さいごに
本日は Amazon Q Developer CLI のリモート MCP サーバー構成でヘッダーが指定できるようになったので GitHub MCP サーバーに PAT で接続してみました。
PAT での接続が無事できましたね。これで Claude Code など他のツールと同様に GitHub リモート MCP サーバーを Amazon Q Developer CLI からも活用できそうです。
一方で OAuth には他のツールと同様に Amazon Q Developer でも使えない状態みたいでした。こちらは GitHub 側のアップデートが必要なのだろうか。