Skip to main content
AgencyHandy の MCP 接続により、Claude または Cursor に自然言語で話しかけ、AgencyHandy ワークスペースの日常業務を実行できます — すべての画面を自分で開く必要はありません。 操作の主導権はあなたにあります。Claude と Cursor は、あなたが生成したワークスペース API キーでのみ動作し、名前が複数人に一致する場合は確認を求めます。
Workspace Config を開き API keys を管理できるロール（通常は SuperAdmin または Admin）が必要です。Claude Desktop または Cursor を実行する PC には Node.js 20+ も必要です。

​
要件

npm 上の MCP パッケージは agencyhandy-mcp です。Claude と Cursor は npx -y agencyhandy-mcp@1 で実行します。

​
Claude または Cursor MCP を設定する

1

Workspace Config を開く

AgencyHandy で Workspace Config（会社設定）を開き、API Key タブに進みます。
2

ワークスペース API キーを生成

新しいワークスペース API キーを作成（または保存済みのキーを使用）します。表示されたらコピーしてください — 後から完全なキーを再表示できません。
3

MCP 設定をコピー

同じ API Key タブの Claude / Cursor MCP セットアップパネルで Copy MCP config をクリックし、キーとバックエンド URL を含む JSON を取得します。
4

Cursor または Claude Desktop に貼り付け

設定を次に貼り付けます：
  • Cursor：プロジェクトまたはユーザーの .mcp.json
  • Claude Desktop：claude_desktop_config.json
生成された npx -y agencyhandy-mcp@1 コマンドと API キーをそのまま保持します。
5

再起動してプロンプトを試す

Cursor または Claude Desktop を完全に終了して開き直します。その後、ワークスペースの朝のブリーフィングなど簡単な依頼をしてください。
Claude または Cursor が MCP サーバーを見つけられない場合は、Node.js 20+ の導入と、設定保存後のアプリ再起動を確認してください。

​
プロンプトの例

自然言語を使います。作業を割り当てるときは、正しい人を選ぶためにフルネームまたはメールを優先してください。

​
同名の人が二人いる場合

チームに Sara が二人いる場合、Claude はどちらを指すか確認します。ID を捏造せず、黙って推測もしません。 名前が衝突しそうなときは、プロンプトに必ずフルネームまたはメールを含めてください。

​
今できること vs まだできないこと

MCP は API キーでワークスペースの読み取りと操作（作成・割当・送信・更新）をサポートします。クライアントチャットの返信はまだ MCP 経由で公開されていません — その会話は AgencyHandy を使ってください。

​
関連

  • アプリ内の Workspace Config → API Key でキーを生成し設定をコピー
Latest package on the 1 tag is 1.7.2+. Claude can read ah://api-context (also inside ah://full-context) for API path gotchas: leads, projects/orders, tasks, comments, labels, clients, invoices, vouchers, and forms.