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 を確認しましょう:

🤖 Node.js の有無を Claude に確認してもらう(Desktopのみ)
Claudeプロンプト
node -v を実行して、Node.js がインストールされているか確認してください。 入っていない場合は、Mac で入れるいちばん簡単な方法を教えてください。

ステップ1 — アクセス権を得る(管理者に依頼) 👤

既定では、多くの人は MCP のトークンページにアクセスできません。そのため最初のステップは、たいてい管理者に依頼することです。方法は2つあります。

方法1(いちばん簡単)— 管理者にトークンを代理発行してもらう。 管理者は管理ダッシュボードからあなた用のトークンを作成し、mcp_… の文字列を渡せます。用途(どのデータを使いたいか)を伝えると、適切なスコープを選んでもらえます。トークンはパスワード同様に扱ってください — 一度しか表示されません。

方法2 — 管理者に MCP アクセス権を付与してもらい、自分で発行する。 管理者にアカウントへ 「mcp」アプリを付与してもらったら、https://mcp.algoritmigroup.com/My MCP TokensIssue new token で、ラベルと必要な スコープを選び、トークンをコピーします(一度しか表示されません)。

スコープ=Claude が見てよい範囲です。読み取りなら、必要な read スコープ(例: シフト、まかない)を選びます。**書き込みは管理者のみ。**スコープは作り直さずに後で変更できます。

誰に頼む? — 現在の管理者は以下のスタッフです:

依頼できる管理者

管理者を読み込み中…

どの方法でも、トークンは厳重に管理してください — 共有チャットに貼ったり、コードにコミットしたりしないこと。

ステップ2 — 接続する

普段使っているクライアントを選んでください。Claude Code がいちばん簡単です。

方法A — Claude Code(推奨)

プロンプトにトークンを貼り付けて、Claude Code に渡します:

🤖 Claude Code に接続してもらう
Claudeプロンプト
algoritmi の MCP サーバーに接続したいです。プレースホルダを自分のトークンに置き換えて、次のコマンドをそのまま実行してください: claude mcp add --transport http --scope user algoritmi-vibe https://mcp.algoritmigroup.com/api/mcp --header "Authorization: Bearer mcp_あなたのトークン" その後 "claude mcp list" を実行して、"algoritmi-vibe" が connected になっているか教えてください。

または、自分でターミナルから実行:

👤 サーバーを追加(Claude Code)bash
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 Code に Claude Desktop を設定してもらう
Claudeプロンプト
algoritmi の MCP サーバーを Claude Desktop の設定ファイルに追加してください(無ければ作成。既にあるサーバーは消さないでください): macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json 次の "algoritmi-vibe" を "mcpServers" にマージし、mcp_YOUR_TOKEN_HERE を私が渡すトークンに置き換えてください: { "mcpServers": { "algoritmi-vibe": { "command": "npx", "args": ["-y", "mcp-remote", "https://mcp.algoritmigroup.com/api/mcp", "--header", "Authorization:${AUTH_HEADER}"], "env": { "AUTH_HEADER": "Bearer mcp_YOUR_TOKEN_HERE" } } } } "Authorization:${AUTH_HEADER}" と AUTH_HEADER 環境変数は、書かれているとおりそのまま使ってください — "Bearer <token>" のスペースで引数が分割されるのを防ぐためです。

そのあと、手動で: Claude Desktop を完全に終了して開き直してください 👤(新しい設定を読み込ませるため)。チャット入力欄のツール(スライダー)メニューを開くと、algoritmi-vibe のツールが表示されます。

手動で貼り付ける場合の設定:

claude_desktop_config.jsonjson
{
  "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プロンプト
algoritmi の MCP ツールを使って、次を教えてください: 1. 私のトークンでどんなデータにアクセスできますか?権限は何ですか(どのスコープで、読み取りだけか書き込みもできるか)? 2. 私が使えるツールの一覧と、それぞれが何をするかを教えてください。 3. アクセスできるものの中から、実データを使った具体例を1つ見せてください。

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

クイズ

Quiz

MCP のトークンページにアクセスできません。最初にやることは?