メインコンテンツへスキップ

Josys MCPをClaudeで利用する

更新

概要

本ページではJosys MCPをClaudeで利用するための手順を記載しています。
参考：Josys MCP - クイックスタートガイド

事前準備

Claude DesktopからJosys MCPを利用するには、以下が必要です。

  • Claude Desktop
  • Node.js バージョン20以上
  • Josysのスーパーアドミン権限
  • Josys MCP用アクセストークン

Node.jsについて

Claude DesktopからJosys MCPへ接続する際に、Node.jsを使用します。
Node.jsがインストールされていない場合は、あらかじめインストールしてください。

手順

  1. Josysにログインします。
  2. Josysの左下の「設定」＞「開発者」をクリックします。
  3. 右上の「＋作成」をクリックします。
  4. ポップアップが表示されたら、「アクセストークン(Josys MCP用)」を選択します。
    一意のラベルはどこで誰が利用しているか分かるような名前を推奨します。
  5. 完成するとトークンが表示されるため、控えてください。一度ページを閉じると表示されなくなるためご注意ください。
  6. Claude Desktopを起動します。 
  7. ［Settings］を開きます。 
  8. ［Developer］＞［Edit Config］をクリックします。
  9. エクスプローラーが開き、claude_desktop_config.jsonが選択されているので、ファイルを開いてください。
  10. 最下部までスクロールし、以下のように更新をしてください。

更新方法

  1. ファイルの末尾にある「}」を削除してください。
  2. 以下をコピーし、PASTE_YOUR_ACCESS_TOKEN_HEREを先ほど取得したトークンに書き換えてファイルの末尾に貼り付けて保存し、ファイルを閉じてください。
  "mcpServers": {
    "JOSYS": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.josys.it/mcp",
        "--header",
        "x-agent-token:${AGENT_TOKEN}"
      ],
      "env": {
        "AGENT_TOKEN": "PASTE_YOUR_ACCESS_TOKEN_HERE"
      }
    }
  }
}

URL部分は以下を参照の上適宜変更してください。

ログインしているJosysのURL 使うMCPサーバーURL
https://app.josys.it https://mcp.josys.it/mcp
https://app.us.josys.it https://mcp.us.josys.it/mcp

実際にClaudeで利用する

  1. Claudeを一度閉じ、再度起動してください。
  2. チャットが開いたら、質問をしてください。
    MCPの利用にはアクセス許可を求めてくる場合があるため、許可の実行をお願いします。

関連記事