Gripp MCP

Model Context Protocol 服务器，用于 Gripp API 3.0 端点 https://api.gripp.com/public/api3.php。

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 远程 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

如果未设置 MCP_ACCESS_KEY，/api/mcp 端点在生产环境中会默认拒绝访问。如果 URL 泄露，请在 Vercel 中轮换 MCP_ACCESS_KEY 并重新部署。

远程端点还可以从 Authorization: Bearer <token> 或 x-gripp-api-token 读取 Gripp 令牌，但 Claude 的自定义连接器界面目前不提供简单的自定义请求头字段。对于 Claude，实际可行的设置是将 GRIPP_API_TOKEN 存储在 Vercel 项目环境中。

GoHighLevel 远程 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

UPSTASH_REDIS_REST_URL 和 UPSTASH_REDIS_REST_TOKEN 也可以代替 KV_* 名称使用。

在 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：

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

通过重新打开 /api/connect/start 并选择下一个 Location，为每个子账户安装一次应用。MCP 会维护所有已连接安装的索引。在 Claude 中，先调用 ghl_list_installations，然后将选定的 installId 传给联系人、商机或通用 API 工具。

如果你的 Marketplace 应用只能由机构管理员安装，请设置 GHL_OAUTH_USER_TYPE=Company。在机构级别安装一次后，使用 ghl_list_installed_locations 查看应用实际安装的位置，然后使用 ghl_connect_location 为你要查询的子账户创建一个存储的 Location 安装。ghl_list_locations 仅列出可见的子账户，并不能证明应用已安装在这些子账户上。

如果缺少 GHL_MCP_ACCESS_KEY、加密令牌存储或 OAuth 凭据，GoHighLevel MCP 在生产环境中会默认拒绝访问。

GoHighLevel 工具

• ghl_installation_status：显示 OAuth 安装元数据，但不暴露令牌。

• ghl_list_installations：列出所有已连接的子账户/安装。

• ghl_list_locations：从已连接的机构/公司安装中列出/搜索子账户。

• ghl_list_installed_locations：列出此应用已安装/已授权的 Location。

• ghl_connect_location：根据机构/公司安装创建并存储一个 Location 令牌。

• ghl_get_contact：按联系人 ID 检索单个联系人。

• 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，请将官方的 googleads/google-ads-mcp 服务器作为独立的远程服务运行，而不是使用本地 stdio MCP 进程。

有关 Cloud Run 部署和 Claude 自定义连接器设置，请参阅 docs/google-ads-mcp-claude.md。

工具

• gripp_list_entities：列出可用的 Gripp 实体和方法名称。

• gripp_describe_entity：检查单个实体的字段、枚举值、引用、方法和示例。

• 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：在单个事务中执行多个有文档记录的 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 文档时，请刷新它。