MCPでClaudeをプロジェクト管理ツールに接続する方法

MCPとは

Model Context Protocol（MCP）は、AIアシスタントが別のアプリケーションのツールを呼び出せるようにするオープン標準です。MCPサーバーを提供するプロジェクト管理ツールは、「自分の課題を一覧表示する」「課題を作成する」といったツールの一覧を公開し、Claude Codeなどのクライアントが、あなたが与えた権限の範囲内でそれらを代わりに呼び出します。

実際には、これは3つのことを意味します。アシスタントは貼り付けられた断片ではなく、実際のボードをもとに作業します。提案するだけでなく、操作まで実行できます。そして、すべての操作はツール自身の権限チェックを通るため、あなた自身ができることしかできません。

始める前に必要なもの

• ツールのアカウント。 Atrixの場合はワークスペースです。無料プランはありません。すべてのワークスペースは7日間のBuilderトライアル（カード登録が必要）から始まり、MCPサーバーはすべてのプランに含まれています。
• サーバーのアドレス。 Atrixの場合は https://atrix.dev/api/mcp で、Streamable HTTPで提供されています。
• クライアント。 Claude Code、WebまたはデスクトップのClaude、Cursor、そのほかHTTP経由でMCPを扱えるクライアントであれば利用できます。

以下のどのクライアントでも、APIキーを作成する必要はありません。いずれもブラウザからOAuthでサインインします。

Claude Codeを接続する

コードとボードを同じセッションで読めるアシスタントが欲しいなら、Claude Codeが最適です。

1. サーバーを追加します。コマンドに認証情報は含めません。

   claude mcp add --transport http atrix https://atrix.dev/api/mcp
   

2. Claude Codeを起動して /mcp を実行し、atrix を選んで Authenticate を選択します。

3. ブラウザのウィンドウが開きます。サインインしてワークスペースを選び、スコープを承認します。最初の接続では読み取り権限だけを求めます。

4. ターミナルに戻り、接続できたか確認します。

   Who am I connected to Atrix as, and what can you do?
   

   Claudeは atrix_whoami を呼び出し、接続しているユーザー、ワークスペース、接続が持つスコープ、そして使えるツールを報告します。

CIやブラウザのないサーバーでは、代わりに個人トークンを渡せます。Atrixの Settings → Atrix Tokens でトークンを作成し、環境変数に保存してください。

claude mcp add --transport http atrix https://atrix.dev/api/mcp \
  --header "Authorization: Bearer $ATRIX_TOKEN"

ノートPCでは、ブラウザでのサインインをおすすめします。ディスクに置くなら、有効期限の長いキーよりも、更新と取り消しができるOAuthトークンのほうが安全です。

ClaudeとClaude Desktopを接続する

WebのClaudeとClaude Desktopでは、カスタムコネクタを使います。

1. Settings → Connectors → Add custom connector（設定 → コネクタ → カスタムコネクタを追加）を開きます。

2. 名前を付けて、エンドポイントを貼り付けます。

   https://atrix.dev/api/mcp
   

3. Connect を選択し、開いたウィンドウでAtrixにサインインします。

Claudeはサーバーに自分自身を登録するため、クライアントIDやシークレットを作成する必要はありません。会社のClaudeプランを使っている場合は、カスタムコネクタを追加する前に管理者による許可が必要なことがあります。

Cursorを接続する

Cursorをはじめ、Streamable HTTPに対応したほとんどのクライアントは同じJSONを使います。プロジェクト内の .cursor/mcp.json に書くか、どこでも使いたい場合は ~/.cursor/mcp.json に書きます。

{
  "mcpServers": {
    "atrix": { "url": "https://atrix.dev/api/mcp" }
  }
}

初めてツールが呼び出されたとき、Cursorはサインインのためにブラウザを開きます。トークンを使う場合は次のようにします。

{
  "mcpServers": {
    "atrix": {
      "url": "https://atrix.dev/api/mcp",
      "headers": { "Authorization": "Bearer atx_pat_…" }
    }
  }
}

接続後の権限の仕組み

最初の接続は、あえて読み取り専用になっています。Claudeが何かを変更できるようになる前に、ボードをどう扱うかを確認できます。

課題の作成など書き込みが必要な操作を頼むと、サーバーは 403 insufficient_scope を返し、足りないスコープを伝えます。適切に作られたクライアントはブラウザを再度開き、そのスコープだけを承認できるようにします。クライアントがそうしない場合は、もう一度認証し（Claude Codeなら /mcp）、そこで追加のスコープを承認してください。

すべての接続に共通するルールがいくつかあります。

• スコープは権限を狭めるだけで、広げることはありません。 接続は、それを承認した本人以上のことはできません。crm.value を付与しても、商談金額を見る権限のない人には金額は表示されません。
• 権限は呼び出しのたびにチェックされます。 ワークスペースで誰かがアクセス権を失えば、その人が作ったすべての接続も同時にアクセス権を失います。
• 制限は接続ごとです。 1分あたり120回の呼び出しと30回の書き込みまでで、超えるとサーバーは Retry-After ヘッダー付きの 429 を返します。
• すべての呼び出しは監査されます。 ツール、スコープ、結果が記録されますが、記録されるのはIDであり、内容は記録されません。
• 給与には一切アクセスできません。 給与に届くスコープはありません。

実際に使えるプロンプト

以下はAtrixサーバーが提供するツールに直接対応しています。ツール名を指定する必要はなく、Claudeが選びます。承認の確認画面で何が表示されるか分かるように、ツール名も載せています。

一日を始める

• 「今週、自分の期限切れのタスクは？」には attention_today が使われ、期限切れと今週期限のタスク、未読のメンション、今日のミーティングが返されます。
• 「Websiteプロダクトの状況は？止まっているものは？」には project_status が使われ、完了率、ステータス別のタスク、1週間以上レビュー中または進行中のままのものが分かります。

探して読む

• 「価格の仕様書を探して、未解決の論点をまとめて」には search と fetch が使われます。検索はタイトルだけでなく、ページ本文にもマッチします。
• 「Zaraに割り当てられていてレビュー中のものをすべて見せて」には people_find と work_list_issues が使われます。

タスクを作成・変更する（work.write が必要）

• 「Websiteに課題を作成して：『フッターの壊れた価格リンクを修正』、優先度は高、期限は金曜、担当は自分」には work_create_issue、続いて work_schedule_issue と work_assign_issue が使われます。
• 「チェックアウトのバグ3件をIn reviewに移して、修正はステージングにあるとコメントして」には work_bulk_update と work_comment_issue が使われます。

コードからボードへ（Claude Code）

• 「src/billing のTODOコメントを読んで、TODOごとにWebsiteにタスクを1件ずつ作成して。重複は作らないで」。Claudeはローカルでファイルを読み、ifNotExists 付きで work_create_issue を呼び出します。同じタイトルの未完了の課題がすでにあれば、二重に作らずにその課題を返します。

サーバーが意図的に拒否する操作が1つあります。アシスタントはエピックを作成できません。エピックは仕事の枠組みを決めるものなので、Claudeはストーリー、タスク、バグを作成し、その親を設定します。

どのプロジェクト管理ツールのMCPサーバーでも確認すべきこと

Atrixは選択肢の1つです。どのツールを接続するにしても、アシスタントに書き込み権限を与える前に次の点を確認してください。

1. OAuthかAPIキーか。 OAuthなら、同意画面で承認したスコープ付きのトークンになり、ほかを何も変えずに取り消せます。貼り付けたAPIキーは、アカウントでできることをすべて持っていることが多く、設定ファイルに残ります。
2. スコープ。 書き込みなしで読み取りだけを付与できますか。プロジェクト、顧客、人事データを分けられますか。選択肢が「すべて」しかないなら、その接続はパスワードと同じように扱ってください。
3. 書き込みの承認。 クライアントは書き込みのたびに確認を求めますか。サーバーはどのツールが読み取り専用かを示していますか。依頼を誤解したモデルがぶつかるべきなのは確認画面であり、あなたのデータではありません。
4. 監査。 接続がいつ何をしたかを確認できますか。「この20件の課題を閉じたのは誰？」に答えられるのは、ツール呼び出しのログです。
5. レート制限。 暴走したループは、バックログの最後ではなく制限で止まるべきです。
6. モデルが読むもの。 チケットの本文やコメントはモデルが読みます。誰かがチケットに指示を書き込むこともできるので、重要なものには書き込みの承認をオンにしておいてください。

うまくいかないとき

• 401: サインインの有効期限が切れたか、取り消されています。/mcp を実行して再度認証してください。
• 403 insufficient_scope: 接続にスコープが足りません。ブラウザが開いたら承認するか、そのスコープ付きで接続し直してください。
• スコープ名のない403: スコープはあるものの、あなたのアカウントにワークスペースでの権限がありません。ワークスペースの管理者に相談してください。
• 429: Retry-After に示された秒数だけ待ってください。短い間隔で再試行を繰り返すと、待ち時間が延びるだけです。

よくある質問

無料でClaudeをAtrixに接続する方法はありますか？

ありません。Atrixには無料プランがありません。すべてのワークスペースは7日間のBuilderトライアル（カード登録が必要）から始まり、MCPサーバーは初日から使えます。Builderは5席で月額39ドル、Studioは15席で月額149ドルで、年額プランは20%オフです。

Claudeが確認なしにボードを変更することはありますか？

読み取り専用の最初の接続ではありません。書き込みにはブラウザで承認するスコープが必要で、Claude Codeなどのクライアントも、そうしないよう設定していない限り、ツールを実行する前に確認を求めます。

AtrixはClaudeとの会話を見ていますか？

いいえ。サーバーが見るのは、検索クエリや作成する課題の項目など、Claudeが行うツール呼び出しだけです。監査ログに記録されるのはIDで、内容ではありません。

どのクライアントを使うべきですか？

TODOや失敗したテストを課題にするなど、仕事がコードから始まるならClaude Codeを使いましょう。計画、状況の確認、文章作成にはClaudeまたはClaude Desktopが向いています。普段Cursorで作業しているならCursorで構いません。3つとも同じツールに同じ制限でアクセスします。

接続を解除するには？

クライアントでサーバーを削除し（Claude Codeなら claude mcp remove atrix）、Atrixの設定で接続を取り消します。Atrixで取り消すと、次のリクエストから使えなくなります。

自分のボードで試してみる

料金ページからワークスペースを始め、上の手順でClaudeを接続して、期限切れのタスクを聞いてみてください。MCPサーバーガイドにはすべてのクライアントの設定方法が、ツールリファレンスにはすべてのツールとそのスコープ、入力項目が載っています。概要はAtrixとClaudeとMCP機能ページをご覧ください。