Claudeをプラットフォームに接続する (MCP)
Claude Code や Claude Desktop から、シフト・まかない・料金などのプラットフォームの最新データを読めるようにします。設定は一度だけ。ほとんどはあなたのClaudeがやってくれます。
これは何?
プラットフォームには MCPサーバー があります。これは、あなたの Claude(Claude Code または Claude Desktop)がプラットフォームの最新データ(シフト・まかない・採用/HR・料金など)を読めるようにする、安全な「橋渡し」です。接続できると、「今月のシフトを見せて」 のように Claude に頼むだけで、本物のデータを取ってきてくれます。
設定は 一度だけで、ほとんどはあなたの Claude にやってもらえます。あなたが手でやるのは数ステップだけ — おもに「トークンを入手する(多くの場合は管理者に依頼)」ことと、(Claude Desktop の場合)「アプリを再起動する」ことです。
ほとんどの人にとって MCP は 読み取り専用です。データの変更(シフトやまかないの編集など)は管理者だけが行えます。
このページの記号:
- 🤖 = あなたの Claude に任せられる手順(プロンプトをコピーして渡す)。
- 👤 = あなたが手でやる手順。
はじめる前に
| 必要なもの | 理由 | 担当 |
|---|---|---|
| MCP アクセス権(既定では多くの人は持っていません) | トークンを入手するため | 👤 管理者に依頼 — ステップ1参照 |
| Claude Code(推奨)または Claude Desktop | 接続するクライアント | 👤 あなた |
| Node.js(Claude Desktop のみ) | 接続用の小さな橋渡しを動かすため | 🤖 Claude が確認できます |
Claude Desktop を使う予定なら、まず Node.js を確認しましょう:
ステップ1 — アクセス権を得る(管理者に依頼) 👤
既定では、多くの人は MCP のトークンページにアクセスできません。そのため最初のステップは、たいてい管理者に依頼することです。方法は2つあります。
方法1(いちばん簡単)— 管理者にトークンを代理発行してもらう。
管理者は管理ダッシュボードからあなた用のトークンを作成し、mcp_… の文字列を渡せます。用途(どのデータを使いたいか)を伝えると、適切なスコープを選んでもらえます。トークンはパスワード同様に扱ってください — 一度しか表示されません。
方法2 — 管理者に MCP アクセス権を付与してもらい、自分で発行する。 管理者にアカウントへ 「mcp」アプリを付与してもらったら、https://mcp.algoritmigroup.com/ → My MCP Tokens → Issue new token で、ラベルと必要な スコープを選び、トークンをコピーします(一度しか表示されません)。
スコープ=Claude が見てよい範囲です。読み取りなら、必要な read スコープ(例: シフト、まかない)を選びます。**書き込みは管理者のみ。**スコープは作り直さずに後で変更できます。
誰に頼む? — 現在の管理者は以下のスタッフです:
管理者を読み込み中…
どの方法でも、トークンは厳重に管理してください — 共有チャットに貼ったり、コードにコミットしたりしないこと。
ステップ2 — 接続する
普段使っているクライアントを選んでください。Claude Code がいちばん簡単です。
方法A — Claude Code(推奨)
プロンプトにトークンを貼り付けて、Claude Code に渡します:
または、自分でターミナルから実行:
claude mcp add --transport http --scope user algoritmi-vibe https://mcp.algoritmigroup.com/api/mcp --header "Authorization: Bearer mcp_あなたのトークン"確認: Claude Code で /mcp と入力すると、algoritmi-vibe が connected になり、ツール一覧が表示されるはずです。
方法B — Claude Desktop
Claude Desktop には小さな 橋渡し(mcp-remote)が必要です。いちばん簡単なのは、Claude Code に設定ファイルを書いてもらう方法です:
そのあと、手動で: Claude Desktop を完全に終了して開き直してください 👤(新しい設定を読み込ませるため)。チャット入力欄のツール(スライダー)メニューを開くと、algoritmi-vibe のツールが表示されます。
手動で貼り付ける場合の設定:
{
"mcpServers": {
"algoritmi-vibe": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.algoritmigroup.com/api/mcp", "--header", "Authorization:${AUTH_HEADER}"],
"env": { "AUTH_HEADER": "Bearer mcp_あなたのトークン" }
}
}
}ヒント: 同じ設定は、MCP サイトのトップページの 「Claude Desktop / Cursor config」 にコピーできる形で表示されています。
ステップ3 — 何にアクセスできるか確認する
何ができるかは、トークンのスコープによって人それぞれ異なります。推測せず、Claude に実データで教えてもらいましょう:
Claude が、あなたのトークンで使えるツールの一覧と実例を示してくれます。「使えるツールが無い」や権限エラーが出た場合は、下のトラブルシュート表を参照してください。
うまくいかないとき
| 症状 | 意味 / 対処 |
|---|---|
| Claude が接続できない/認証に失敗する(401) | トークンが誤り・期限切れ・失効。新しく発行し直し(ステップ1)、mcp_… の全体を Bearer 付きで使っているか確認。 |
ツールが insufficient_scope で拒否される | そのトークンにその範囲が含まれていない。https://mcp.algoritmigroup.com/ に戻り、一覧から自分のトークンを開いて Edit scopes で必要な範囲を追加(書き込みは管理者のみ)。 |
| ツールが出ない(Claude Desktop) | Node.js が無い、または Claude Desktop を完全に再起動していない。Node.js を確認し、アプリを完全に終了して開き直す。 |
| トークンのページが開けない/発行できない | アカウントに 「mcp」アプリの権限がまだ無い。管理者に依頼(または代理発行を依頼)。 |
担当のまとめ
| 手順 | 担当 |
|---|---|
| Node.js の確認(Desktop) | 🤖 Claude |
| アクセス権/トークンの入手 | 👤 あなた — 管理者に依頼(ステップ1) |
| サーバーの追加(Claude Code) | 🤖 Claude — またはコマンド1つ |
| Claude Desktop の設定ファイル作成 | 🤖 Claude Code |
| Claude Desktop の再起動 | 👤 あなた |
| アクセスできる範囲の確認 | 🤖 Claude |
クイズ
MCP のトークンページにアクセスできません。最初にやることは?