MCP 経由で MOCO を Cursor に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → MOCO をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

MOCO + Cursor

AI に MOCO のアカウントで作業させます。プロジェクトと顧客の参照、担当者別やプロジェクト別の工数の確認、未払いの請求書とチームの稼働率のチェック、工数の登録ができます。MOCO のサブドメインと、MOCO のプロフィールで取得する API キーを使います。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

MOCO_SUBDOMAIN, MOCO_API_KEY

ステップ 1 — 認証情報を取得

1. MOCO で右上のプロフィール画像をクリックしてプロフィールを開き、Integrations タブで個人用の API キーをコピーします。このキーで使えるのは、あなたの MOCO ユーザーが見られるもの、できることだけです。
2. 代わりに、Settings → Extensions → API & Webhooks → API Keys でアカウントの API キーを作成することもできます。権限は読み取り専用かフルアクセスを選べます。読み取り専用のキーでは工数を登録できません。
3. キーを MOCO_API_KEY に貼り付けます。
4. MOCO_SUBDOMAIN には MOCO のアドレスの最初の部分だけを設定します。agency.mocoapp.com なら agency と入力し、https:// や .mocoapp.com は付けません。コネクターは https://agency.mocoapp.com/api/v1 を呼び出します。
5. コネクターをインストールします。Authorize with Provider の手順はありません。キーは暗号化して保存され、リクエストごとに送信されます。
6. まず moco_list_users を実行します。同僚の名前と ID が表示されれば、キーとサブドメインは正しく設定されています。

サインイン状態の維持: コネクターはキーをそのまま使うため、更新が必要なサインインはありません。MOCO でキーを差し替えたり削除したりした場合は、新しいキーを MOCO_API_KEY に貼り付けてください。

AI が見られる範囲: どの一覧も、キーのユーザーに閲覧権限があるレコードだけを返します。プロジェクトや請求書が見つからない場合、たいていはコネクターの不具合ではなく MOCO 側の権限の問題です。

工数の登録: MOCO に書き込むツールは moco_create_activity だけです。キーの持ち主のユーザーに 1 件の工数を登録します。指定するのは日付、プロジェクト ID、タスク ID、秒単位の時間（2 時間なら 7200）、任意の説明です。AI は moco_list_projects でプロジェクトを、moco_get_project でそのタスクを探します。呼び出すたびに新しいエントリーが作られ、同じ呼び出しを繰り返すと工数が二重に登録されます。そのため AI は先に日付、プロジェクト、タスク、時間を示し、あなたの承認を待ちます。

権限と読み取り専用の設定: 読み取りだけのコネクターにするには、コネクターのページで moco_create_activity を無効にするか、読み取り専用のアカウント API キーを使います。データを読むだけの人にフルアクセスのキーを渡さないでください。

レポートと請求書: moco_list_activities と moco_report_utilization には、常に開始日と終了日（from と to、形式は YYYY-MM-DD）が必要です。工数は担当者、プロジェクト、請求対象の時間だけに絞り込めます。稼働率レポートは、使える工数と予定済みの工数を比較します。moco_list_invoices はステータス（draft、created、sent、partially_paid、paid、overdue、ignored。カンマ区切りで複数指定可）、請求日、会社で絞り込めます。

制限: 一覧は 1 ページ最大 100 件で、AI は最後のページまで続けて取得します。MOCO の標準プランでは 2 分あたり約 120 リクエストまでです。超えると 429 が返るので、少し待ってからやり直してください。

よくあるエラー: 401 は、キーが間違っている、削除された、または MOCO_SUBDOMAIN とは別の MOCO アカウントのキーであることを示します。すべての呼び出しが失敗する場合は、MOCO_SUBDOMAIN にアドレス全体ではなくサブドメインだけが入っているか確認してください。特定のプロジェクトで 404 が返る場合は、ID が間違っているか、キーのユーザーにそのプロジェクトの閲覧権限がありません。登録が拒否されたときは、MOCO が受け付けなかった項目が示されます。たとえば、そのプロジェクトに属さないタスクを指定した場合です。

このコネクターは、請求書の作成や送信、PDF のダウンロード、Webhook の設定、工数の編集や削除、プロジェクト、会社、ユーザーの変更は行いません。

ステップ 2 — アダプターをインストール

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

ステップ 3 — Cursor にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Cursor は ~/.cursor/mcp.json から MCP サーバーを読み込みます。次のエントリを追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、Cursor を再起動します。
3. Cursor → Settings → MCP を開き、anythingmcp が一覧にあり接続済みであることを確認します。
4. チャットを始めましょう。エージェントが MOCO のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「9 月に Website Relaunch プロジェクトでチームが登録した工数は何時間？そのうち請求対象はどれくらい？」
• 「いま期限切れ、または一部だけ支払われている請求書はどれ？それぞれどの顧客のもの？」
• 「先月のチームの稼働率はどうだった？使える工数と予定済みの工数を比較して。」
• 「今日の工数として、Acme のウェブサイトプロジェクトにトップページのレイアウトレビューで 2.5 時間登録して。登録する前に内容を見せて。」

FAQ

Cursor の無料プランでカスタム MCP サーバーは使えますか? はい。MCP は Hobby、Pro、Business の各プランで利用できます。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続
• Gemini に接続
• Meta Muse に接続