Gripp MCP

https://api.gripp.com/public/api3.php にある Gripp API 3.0 エンドポイント用の Model Context Protocol サーバー。

Gripp API は JSON-RPC に似ています。リクエストはバッチ配列として POST され、API トークンは Authorization: Bearer <token> として送信されます。

セットアップ

npm install
npm run fetch:metadata
npm run build

サーバーを起動する前に Gripp API トークンを設定してください:

export GRIPP_API_TOKEN="your-token"
npm start

オプションの環境変数:

GRIPP_API_URL=https://api.gripp.com/public/api3.php
GRIPP_REQUEST_TIMEOUT_MS=30000

GRIPP_API_URL は意図的に https://api.gripp.com/ ホストに制限されています。

Related MCP server: SuperOps MCP Server

MCP クライアント設定

stdio 設定の例:

{
  "mcpServers": {
    "gripp": {
      "command": "node",
      "args": ["/absolute/path/to/MCP Gripp/dist/src/cli.js"],
      "env": {
        "GRIPP_API_TOKEN": "your-token"
      }
    }
  }
}

パッケージを公開またはリンクした後、gripp-mcp バイナリを実行することもできます。

Vercel Remote MCP

このリポジトリは、Next.js ルートを通じて Vercel 用の Streamable HTTP MCP エンドポイントも公開しています:

https://your-vercel-domain.vercel.app/api/mcp

Claude のカスタムコネクタには、/api/mcp URL を使用してください。ルート URL はヘルスレスポンスのみを返します。

Gripp ツールを使用する前に、この環境変数を Vercel に設定してください:

GRIPP_API_TOKEN=your-token
MCP_ACCESS_KEY=long-random-secret

Claude のカスタムコネクタ URL でアクセスキーを使用してください:

https://your-vercel-domain.vercel.app/api/mcp?access_key=long-random-secret

/api/mcp エンドポイントは、MCP_ACCESS_KEY が設定されていない場合、本番環境ではフェイルクローズします。URL が漏れた場合は、Vercel で MCP_ACCESS_KEY をローテーションして再デプロイしてください。

リモートエンドポイントは Authorization: Bearer <token> または x-gripp-api-token から Gripp トークンを読み取ることもできますが、Claude のカスタムコネクタ UI には現在、シンプルなカスタムヘッダーフィールドがありません。Claude では、GRIPP_API_TOKEN を Vercel プロジェクトの環境に保存するのが実用的な設定です。

GoHighLevel Remote MCP

同じ Vercel プロジェクトで、OAuth トークンストレージを備えた GoHighLevel MCP エンドポイントもホストできます:

https://your-vercel-domain.vercel.app/api/connect/mcp

Vercel でこれらの環境変数を設定してください:

GHL_CLIENT_ID=your-highlevel-client-id
GHL_CLIENT_SECRET=your-highlevel-client-secret
GHL_APP_ID=your-highlevel-app-or-version-id
GHL_INSTALL_URL=your-highlevel-installation-url
GHL_REDIRECT_URI=https://your-vercel-domain.vercel.app/api/connect/callback
GHL_OAUTH_USER_TYPE=Company
GHL_MCP_ACCESS_KEY=long-random-secret
GHL_TOKEN_ENCRYPTION_KEY=$(openssl rand -hex 32)
KV_REST_API_URL=your-upstash-or-vercel-kv-rest-url
KV_REST_API_TOKEN=your-upstash-or-vercel-kv-rest-token

KV_* 名の代わりに UPSTASH_REDIS_REST_URL と UPSTASH_REDIS_REST_TOKEN も使用できます。

HighLevel Marketplace アプリ設定で、このリダイレクト URL を追加してください:

https://your-vercel-domain.vercel.app/api/connect/callback

次に、ブラウザで OAuth 開始 URL を開いてください:

https://your-vercel-domain.vercel.app/api/connect/start

HighLevel がリダイレクトで戻ると、コールバックページがそのサブアカウントのインストールを保存します。Claude のカスタムコネクタ画面で共有 URL を 1 つ使用してください:

https://your-vercel-domain.vercel.app/api/connect/mcp?access_key=long-random-secret

/api/connect/start を再度開いて次のロケーションを選択することで、サブアカウントごとにアプリを 1 回インストールします。MCP は接続されたすべてのインストールのインデックスを保持します。Claude で最初に ghl_list_installations を呼び出し、選択した installId を連絡先、商談、または汎用 API ツールに渡してください。

Marketplace アプリがエージェンシー管理者のみインストールできる場合は、GHL_OAUTH_USER_TYPE=Company を設定してください。エージェンシーレベルで一度インストールした後、ghl_list_installed_locations を使用してアプリが実際にインストールされている場所を確認し、次に ghl_connect_location を使用して、クエリしたいサブアカウント用の保存済み Location インストールを作成してください。ghl_list_locations は表示可能なサブアカウントのみを一覧表示し、アプリがそれらにインストールされていることを証明するものではありません。

GoHighLevel MCP は、GHL_MCP_ACCESS_KEY、暗号化トークンストレージ、または OAuth 認証情報が欠落している場合、本番環境ではフェイルクローズします。

GoHighLevel ツール

• ghl_installation_status: トークンを公開せずに OAuth インストールメタデータを表示します。

• ghl_list_installations: 接続されたすべてのサブアカウント/インストールを一覧表示します。

• ghl_list_locations: 接続されたエージェンシー/会社インストールからサブアカウントを一覧表示/検索します。

• ghl_list_installed_locations: このアプリがインストール/承認されているロケーションを一覧表示します。

• ghl_connect_location: エージェンシー/会社インストールから Location トークンを作成して保存します。

• ghl_get_contact: 連絡先 ID で 1 件の連絡先を取得します。

• ghl_search_contacts: /contacts/search で連絡先を検索します。

• ghl_create_contact: 連絡先を作成します。confirm: true が必要です。

• ghl_update_contact: 連絡先を更新します。confirm: true が必要です。

• ghl_search_opportunities: /opportunities/search で商談を検索します。

• ghl_api_call: 任意の相対 HighLevel API パスを呼び出します。GET 以外の呼び出しには confirm: true が必要です。

Claude 用の共有 Google Ads MCP

複数の人が Claude で使用できる共有 Google Ads MCP の場合は、ローカルの stdio MCP プロセスを使用する代わりに、公式の googleads/google-ads-mcp サーバーを別のリモートサービスとして実行してください。

Cloud Run のデプロイと Claude のカスタムコネクタ設定については、docs/google-ads-mcp-claude.md を参照してください。

ツール

• gripp_list_entities: 利用可能な Gripp エンティティとメソッド名を一覧表示します。

• gripp_describe_entity: 1 つのエンティティのフィールド、列挙値、参照、メソッド、例を検査します。

• gripp_get: フィルターとオプションを指定して <entity>.get を呼び出します。

• gripp_getone: フィルターを指定して <entity>.getone を呼び出します。

• gripp_create: <entity>.create を呼び出します。confirm: true が必要です。

• gripp_update: <entity>.update を呼び出します。confirm: true が必要です。

• gripp_delete: <entity>.delete を呼び出します。confirm: true が必要です。

• gripp_call: 完全名で任意のドキュメント化された Gripp メソッドを呼び出します。

• gripp_batch: 1 つのトランザクションで複数のドキュメント化された Gripp 呼び出しを実行します。

読み取り以外のメソッドは、confirm: true が指定されない限りブロックされます。これは gripp_call と gripp_batch の各項目にも適用されます。

例

名前で会社を検索:

{
  "entity": "company",
  "filters": [
    {
      "field": "company.companyname",
      "operator": "like",
      "value": "%Acme%"
    }
  ],
  "options": {
    "paging": {
      "firstresult": 0,
      "maxresults": 10
    },
    "orderings": [
      {
        "field": "company.companyname",
        "direction": "asc"
      }
    ]
  }
}

非標準の読み取りメソッドを呼び出す:

{
  "method": "company.getCompanyByCOC",
  "params": ["12345678"]
}

タグを作成:

{
  "entity": "tag",
  "fields": {
    "name": "Imported"
  },
  "confirm": true
}

メタデータ

コミットされたメタデータスナップショットは、公開 API ドキュメントページから生成されます:

npm run fetch:metadata

Gripp が API ドキュメントを更新したときに更新してください。