anthropic-admin-mcp

anthropic-admin-mcp

Anthropic がまだリリースしていない MCP サーバーです。Anthropic Admin API と Usage & Cost API を完全にカバーし、適切な型付けとツール、適切に範囲を制限した安全対策を備えています。

自然言語を使って、あらゆる MCP 互換クライアント（Claude Desktop、Cursor、Windsurf、ChatGPT など）から Anthropic 組織を管理できます。

• 「先週、ワークスペース別に見ると、組織はいくら使いましたか？」
• 「昨日、最も多くの Opus トークンを消費した API キーはどれですか？」
• 「過去 14 日間の Pre-Mortem の使用状況を日ごとに表示してください。」
• 「[email protected] を Sandbox ワークスペースの開発者として招待してください。」
• 「'old-laptop' という名前の API キーを無効化してください。」

読み取りツール 10 個、書き込みツール 10 個、監査ログ、任意のワークスペーススコープ指定、読み取り専用モード、ロール昇格ガードを備えています。

これが存在する理由

Anthropic は、組織管理、ワークスペース、メンバー、API キー、使用状況レポート、コストレポートにわたる約 22 個のエンドポイントを備えた、優れた Admin API を提供しています。サードパーティ製の既存の MCP ラッパーは、商用統合プラットフォームを通じて、そのごく一部しかカバーしていません。このサーバーはネイティブで、無料のオープンソースであり、完全な機能を備えています。お持ちの Admin キーを使って、2 分でインストールできます。

インストール

pip install git+https://github.com/Trushtonfactory/anthropic-admin-mcp.git

または、ローカル開発の場合：

git clone https://github.com/Trushtonfactory/anthropic-admin-mcp.git
cd anthropic-admin-mcp
python3 -m venv .venv
source .venv/bin/activate
pip install -e .

設定

1. console.anthropic.com → Settings → Admin Keys で Admin API キーを取得します。 Organization プラン（Team ／ Pro+ ／ Enterprise）と管理者ロールが必要です。個人アカウントでは Admin キーを作成できません。

2. .env.example を .env にコピーし、キーを入力します。

   cp .env.example .env
   # edit .env: ANTHROPIC_ADMIN_KEY=sk-ant-admin-...
   

3. MCP クライアントに接続します。Claude Desktop の場合は、~/Library/Application Support/Claude/claude_desktop_config.json に追加します。

   {
     "mcpServers": {
       "anthropic-admin": {
         "command": "anthropic-admin-mcp",
         "env": {
           "ANTHROPIC_ADMIN_KEY": "sk-ant-admin-..."
         }
       }
     }
   }
   

   読み取り専用モードやワークスペーススコープ指定など、その他のオプションについては examples/claude_desktop_config.json を参照してください。

ツール

読み取り（10）

ツール	目的
get_org_info	キーの動作確認。組織 ID と名前を返します
list_members	組織のメンバーとロールを一覧表示します
list_invites	保留中および過去の招待を一覧表示します
list_workspaces	アクティブな（および任意でアーカイブ済みの）ワークスペースを一覧表示します
get_workspace	ワークスペース ID に対応する完全なレコードを取得します
list_workspace_members	特定のワークスペースのメンバーを一覧表示します
list_api_keys	ステータス／ワークスペースで絞り込んだキーを一覧表示します
get_usage_report	トークン使用量をワークスペース／api_key／モデルなどでグループ化します
get_cost_report	ドル建てのコストをワークスペース／説明でグループ化します
get_claude_code_usage	Claude Code 固有の使用状況データを取得します

書き込み（10）— すべて confirm=True が必要です

ツール	操作
invite_member	招待を送信します（管理者権限は付与できません）
delete_invite	保留中の招待をキャンセルします
update_member_role	メンバーの組織ロールを変更します（管理者には適用できません）
remove_member	管理者以外のメンバーを削除します
create_workspace	新しいワークスペースを作成します
update_workspace	ワークスペースの名前または色を変更します
archive_workspace	ワークスペースをアーカイブします
add_workspace_member	ワークスペースへのアクセス権を付与します
update_workspace_member_role	ワークスペースのロールを変更します
remove_workspace_member	ワークスペースへのアクセス権を取り消します
update_api_key	API キーの名前を変更するか、無効化します

実行

# Full mode (read + write), stdio transport
anthropic-admin-mcp

# Read-only — recommended for first-time setup
anthropic-admin-mcp --read-only

# Streamable HTTP (for remote MCP clients)
anthropic-admin-mcp --http --port 8000

# Restrict writes to specific workspaces (set in .env or shell)
ALLOWED_WORKSPACES=wrkspc_abc,wrkspc_xyz anthropic-admin-mcp

安全性

脅威モデルと設計に関する詳細は、SECURITY.md を参照してください。概要は次のとおりです。

• 読み取りは公開されています。 Admin API があなたのキーで公開するものはすべて、このサーバーも公開します。
• 書き込みにはガードがあります。 すべての変更操作には confirm=True が必要で、JSONL に監査ログとして記録され、任意のワークスペーススコープが適用されます。
• ロールの昇格はクライアント側でブロックされます。 API 自体もサーバー側でブロックしますが、Claude 向けにより明確なエラーメッセージを表示します。
• 認証情報を外部に流出させる経路はありません。 Admin API がキーの値を返すことはなく、このサーバーが Admin キー自体をログに記録することもありません。

ステータス

v0.1.0 — 読み取りと書き込みのツール一式が完成しました。ページネーション、エラーメッセージ、監査ログを手動でテスト済みです。使用制限はまだ実装されていません。Pydantic のレスポンスモデルは最小限です（ツールは生の dict を返します）。

Issue と PR を歓迎します。

ライセンス

MIT — LICENSE を参照してください。