Agency Handy

Agency Handy MCP サーバー

AI アシスタントを Agency Handy のワークスペースに接続します。Claude、Cursor、VS Code、Cline などの MCP クライアントから、クライアント、リード、プロジェクト、タスク、チケット、請求書、提案について質問したり、作成・更新したりできます。

サーバーは Agency Handy によってホストされています。このリポジトリには接続手順とレジストリ掲載情報が含まれており、ご自身でインストールしたり実行したりする必要はありません。

エンドポイント	https://mcp.agencyhandy.com/（Streamable HTTP、POST /）
認証	Agency Handy でサインイン（OAuth 2.1、PKCE、動的クライアント登録）、または Authorization: Bearer <key> として送信するワークスペース API キー
レジストリ	公式 MCP レジストリ の com.agencyhandy/mcp
ドキュメント	docs.agencyhandy.com

接続方法

Agency Handy でサインインする（推奨）。 アシスタントにサーバー URL を追加すると、Agency Handy のウィンドウが開きます。ワークスペースを入力してサインインし、ワークスペースを選択して Allow をクリックします。コピーや貼り付けは不要です。接続のたびに Agency Handy の Settings → Workspace Config → API Key に表示され、いつでも削除できます。

または、API キーを使用します。 OAuth に対応していないツールでは、Settings → Workspace Config → API Key でキーを生成し、Authorization: Bearer YOUR_API_KEY として送信します。このキーは、1 つのワークスペース内で、ユーザー本人として、そのロールの権限を使って操作します。

クライアントのセットアップ

Claude（claude.ai と Claude Desktop）

Settings → Connectors → Add custom connector（claude.ai の場合：Customize → Connectors → Add）。名前に Agency Handy、URL に https://mcp.agencyhandy.com/ を指定し、Connect をクリックしてサインインします。

ChatGPT

開発者モードで、Settings → Apps & Connectors → Create を選択します。URL に https://mcp.agencyhandy.com/、認証に OAuth を指定し、Agency Handy でサインインします。

Claude Code

使用スキルも追加され、クライアントに何かを送信したり削除したりする前に確認を求めるプラグインをインストールします。

/plugin marketplace add AgencyHandy/claude-plugins
/plugin install agencyhandy@agencyhandy

またはサーバーを直接追加し、/mcp を実行して Authenticate を選択します。

claude mcp add --transport http agencyhandy https://mcp.agencyhandy.com/

代わりに API キーを使用する場合：claude mcp add --transport http agencyhandy https://mcp.agencyhandy.com/ --header "Authorization: Bearer YOUR_API_KEY"

Cursor

~/.cursor/mcp.json を設定し、Cursor の MCP 設定でサーバーの横にある Login をクリックします。

{
  "mcpServers": {
    "agencyhandy": { "url": "https://mcp.agencyhandy.com/" }
  }
}

代わりに API キーを使用する場合は、"headers": { "Authorization": "Bearer YOUR_API_KEY" } を追加します。

VS Code（GitHub Copilot）

.vscode/mcp.json を設定します。サーバーの起動時に、VS Code からサインインを求められます。

{
  "servers": {
    "agencyhandy": { "type": "http", "url": "https://mcp.agencyhandy.com/" }
  }
}

Cline などの stdio 専用クライアント

{
  "mcpServers": {
    "agencyhandy": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.agencyhandy.com/"]
    }
  }
}

mcp-remote はブラウザーでサインイン画面を開きます。代わりに API キーを使用する場合は、"--header", "Authorization: Bearer ${AGENCYHANDY_API_KEY}" を args に追加し、env で AGENCYHANDY_API_KEY を設定します。

できること

すべて ah_ で始まる約 100 個のツールがあります。

• 読み取り： クライアント、リード、クライアント企業、プロジェクトとそのタスク、チケット、コメント、時間記録、請求書、提案、注文、サブスクリプション、サービス、フォーム、カスタムフィールド、Webhook、チャット。
• オーナー向けインサイト： ah_dashboard_digest、ah_cash_risk（支払期限超過およびリスクのある請求書）、ah_client_churn_risk。
• 書き込み： リード、クライアント、タスク、チケット、コメント、請求書、提案、注文、サービスの作成と更新、作業の割り当て、ステータスの変更。
• 送信： ah_invoice_send、ah_proposal_send、ah_client_invite を使ってクライアントにメールを送信します。

ah_health でセッションを開始し、データモデルについては ah://full-context リソースを読み取ってください。

安全性

すべての操作は、接続したユーザーの権限で、そのユーザーが選択したワークスペース内で実行されます。クライアントにメールを送信したり、データを削除したりするツールは、実際の顧客データを変更するため、確定する前にアシスタントの操作案を確認してください。Claude Code プラグインでは、こうした操作の前に必ず確認を求めます。サインイン画面では、アプリが未認証の場合に警告が表示され、リダイレクト先も常に表示されます。

ホスト型サーバーはワークスペースのデータを保存しません。リクエストの短期ログ（ツール、所要時間、メンバーとワークスペースの ID、IP アドレス、キーを削除したエラー）を、最長 14 日間保持します。プライバシーポリシーをご覧ください。

サポート

agencyhandy.com/contact-us · [email protected]