Cavyro

Cavyro MCP サーバー

Cavyroは、エージェントや小規模な営業チーム向けのTelegramネイティブCRMです。連絡先、企業、案件、パイプライン、キャンペーン、ドキュメント、レポートを管理できます。このリポジトリでは、ホスト型のModel Context Protocolサーバーについて説明しています。このサーバーはMCP Registryにcom.cavyro/cavyroとして登録されています。

サーバーはホスト型のため、インストールや実行は不要です。MCP クライアントから接続するだけで、ユーザーの権限に基づいてCavyroワークスペースを読み取り、操作できます。

• エンドポイント： https://ai.cavyro.com/mcp（Streamable HTTP）
• サーバーカード： https://ai.cavyro.com/.well-known/mcp/server-card.json（入力スキーマを含むすべてのツール情報を掲載。認証情報は不要）
• レジストリマニフェスト： server.json · 変更履歴： CHANGELOG.md
• ウェブサイト： cavyro.com · ヘルプ： help.cavyro.com/ai/mcp

サーバーのソースはここでは公開されていません。ツール情報は実行中のサーバーから生成され、上記のサーバーカードで公開されています。そのため、サーバーの機能を説明する正式な情報として、常にこのカードを参照してください。

機能

このサーバーは、API 操作ごとに 1 つのツールを用意するのではなく、リソースとアクションのレジストリを通じて、汎用的な 9 つのツールを固定セットとして公開します。クライアントは必要に応じてリソースとアクションを検出するため、約 90 の CRM 操作に対応しながら、ツールの一覧を小さく保てます。

ツール	目的
describe_resource	すべてのリソースとグローバルアクションのカタログ、または 1 つのリソースのフィルター、ソート項目、列挙型、操作、アクション
query_resources	フィルター、ソート、ページネーション、カスタムフィールドのフィルターを使って、任意のリソースのレコードを一覧表示
get_resource	ID で 1 件のレコードを取得
create_resource	レコードを作成（カスタムフィールドは custom_fields の下にネスト）
update_resource	レコードのフィールドを変更
delete_resource	レコードを discard（アーカイブ）、restore、または destroy
search	エンティティ種別を横断するオムニボックス検索
perform_action	スラッグで指定する、CRUD 以外のあらゆる特殊アクション。案件のステージ間移動、レコードのリンク、一括操作、コメント、レポートなど
load_guidance	必要に応じてワークフローのガイダンスを読み込み。フロー、カスタムフィールド、自動化の作成など

対応ドメイン： 案件、連絡先、会社、パイプラインとステージ、コメントとリアクション、アクティビティフィード、通知、ワークスペース、メンバー、チーム、グループ、招待、カスタムフィールド定義、自動化、ページを含むドキュメント、レポート、読み取り専用の Telegram チャット。

すべてのツールの応答は、共通のエンベロープ { "data": ..., "pagination": ... } を使用します。pagination が含まれるのは、ページネーションされたリスト結果のみです。

接続はあなたとして動作します。外部 AI が参照・実行できるのは、そのワークスペースであなたの Cavyro ロールに許可された範囲のみです。

認証

すべてのリクエストに、次の 2 つのヘッダーが必要です。

ヘッダー	値
Authorization	Bearer <cavyro_api_token>
X-Workspace-Id	あなたのワークスペース ID

Cavyro の Settings → API tokens で API トークンを作成してください。トークンの有効期限は 7 日、30 日、90 日後、またはローテーションできないインテグレーションの場合は無期限に設定できます。トークンを失効させると、クライアントは直ちにアクセスできなくなります。

OAuth フローはありません。サーバーは認証されていないリクエストに 401 と WWW-Authenticate: Bearer realm="cavyro" チャレンジを返します。MCP は Pro の機能です。MCP の呼び出しで Cavyro AI クレジットは消費されず、モデルのトークン料金はお使いのクライアントサブスクリプションで支払われます。

設定

以下のスニペット内の <your-api-token> と <your-workspace-id> を置き換えてください。Cavyro の設定ページでは、ワークスペース ID が入力済みの同じスニペットが生成されます。

VS Code（GitHub Copilot）

.vscode/mcp.json を使用するか、コマンドパレットから MCP: Add Server を選択します。

{
  "servers": {
    "cavyro": {
      "type": "http",
      "url": "https://ai.cavyro.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:cavyro-token}",
        "X-Workspace-Id": "${input:cavyro-workspace}"
      }
    }
  },
  "inputs": [
    {
      "id": "cavyro-token",
      "type": "promptString",
      "description": "Cavyro API token",
      "password": true
    },
    {
      "id": "cavyro-workspace",
      "type": "promptString",
      "description": "Cavyro workspace ID"
    }
  ]
}

Cursor と Claude Desktop

上の Add to Cursor ボタンを使うと、プレースホルダーのヘッダーを含むサーバー設定がインストールされます。~/.cursor/mcp.json でヘッダーを置き換えてください。

Cursor の設定ファイル：~/.cursor/mcp.json。Claude Desktop の設定ファイル：~/Library/Application Support/Claude/claude_desktop_config.json。

{
  "mcpServers": {
    "cavyro": {
      "url": "https://ai.cavyro.com/mcp",
      "headers": {
        "Authorization": "Bearer <your-api-token>",
        "X-Workspace-Id": "<your-workspace-id>"
      }
    }
  }
}

Claude Code

claude mcp add --transport http cavyro https://ai.cavyro.com/mcp \
  --header "Authorization: Bearer <your-api-token>" \
  --header "X-Workspace-Id: <your-workspace-id>"

ChatGPT

Developer Mode（Plus、Pro、Business、Enterprise）で、URL https://ai.cavyro.com/mcp と上記の 2 つのヘッダーを使って、サーバーをコネクターとして追加します。

使い方

接続したら、アシスタントに自然な言葉で依頼してください。次のような使い方ができます。

• 「対応中の案件を金額順に並べて、一番上の案件を Negotiation に移動して。」
• 「Acme の Ana Petrović さんの連絡先を電話番号 +381… で作成し、Acme 社にリンクして。」
• 「Enterprise パイプラインで、過去 30 日間にアクティビティがない案件はどれ？」
• 「Acme との Telegram チャットの直近 1 週間の内容を要約して、相手の案件にコメントとして追加して。」
• 「連絡先に『Lead source』カスタムフィールドを追加し、今作成した連絡先の値を『Referral』に設定して。」

通常、アシスタントはまず describe_resource を呼び出してリソースの構造を確認し、その後 query_resources または perform_action を呼び出します。複数の手順からなる手順が必要な場合は、load_guidance を呼び出します。

サポート

• ヘルプセンター：help.cavyro.com
• メール：[email protected]