Gripp MCP

Servidor del Model Context Protocol para el endpoint de la API 3.0 de Gripp en https://api.gripp.com/public/api3.php.

La API de Gripp es similar a JSON-RPC: las solicitudes se envían mediante POST como un array por lotes, y el token de la API se envía como Authorization: Bearer <token>.

Configuración

npm install
npm run fetch:metadata
npm run build

Establece tu token de la API de Gripp antes de iniciar el servidor:

export GRIPP_API_TOKEN="your-token"
npm start

Variables de entorno opcionales:

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

GRIPP_API_URL está restringido intencionadamente al host https://api.gripp.com/.

Related MCP server: SuperOps MCP Server

Configuración del cliente MCP

Ejemplo de configuración stdio:

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

Después de publicar o enlazar el paquete, también puedes ejecutar el binario gripp-mcp.

MCP remoto en Vercel

Este repositorio también expone un endpoint MCP Streamable HTTP para Vercel a través de una ruta de Next.js:

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

Para los conectores personalizados de Claude, usa la URL /api/mcp. La URL raíz solo devuelve una respuesta de estado.

Configura esta variable de entorno en Vercel antes de usar las herramientas de Gripp:

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

Usa la clave de acceso en la URL del conector personalizado de Claude:

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

El endpoint /api/mcp se bloquea en producción si MCP_ACCESS_KEY no está configurada. Si la URL se filtra, rota MCP_ACCESS_KEY en Vercel y vuelve a desplegar.

El endpoint remoto también puede leer un token de Gripp desde Authorization: Bearer <token> o x-gripp-api-token, pero la interfaz de conectores personalizados de Claude no ofrece actualmente un campo sencillo de cabecera personalizada. Para Claude, la configuración práctica es almacenar GRIPP_API_TOKEN en el entorno del proyecto de Vercel.

MCP remoto de GoHighLevel

El mismo proyecto de Vercel también puede alojar un endpoint MCP de GoHighLevel con almacenamiento de tokens OAuth:

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

Configura estas variables de entorno en 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 y UPSTASH_REDIS_REST_TOKEN también funcionan en lugar de los nombres KV_*.

En la configuración de la aplicación de HighLevel Marketplace, añade esta URL de redirección:

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

A continuación, abre la URL de inicio de OAuth en tu navegador:

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

Cuando HighLevel redirija de vuelta, la página de callback almacena la instalación de esa subcuenta. Usa una URL compartida en la pantalla de conectores personalizados de Claude:

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

Instala la aplicación una vez por subcuenta reabriendo /api/connect/start y eligiendo la siguiente ubicación. El MCP mantiene un índice de todas las instalaciones conectadas. En Claude, llama primero a ghl_list_installations y luego pasa el installId elegido a las herramientas de contacto, de oportunidades o de API genérica.

Si tu aplicación de Marketplace solo puede instalarla un administrador de agencia, establece GHL_OAUTH_USER_TYPE=Company. Después de instalarla una vez a nivel de agencia, usa ghl_list_installed_locations para ver dónde está instalada realmente la aplicación y, a continuación, ghl_connect_location para crear una instalación de Location almacenada para la subcuenta que quieras consultar. ghl_list_locations solo enumera las subcuentas visibles y no demuestra que la aplicación esté instalada en ellas.

El MCP de GoHighLevel se bloquea en producción si faltan GHL_MCP_ACCESS_KEY, el almacenamiento cifrado de tokens o las credenciales OAuth.

Herramientas de GoHighLevel

• ghl_installation_status: muestra los metadatos de la instalación OAuth sin exponer los tokens.

• ghl_list_installations: enumera todas las subcuentas/instalaciones conectadas.

• ghl_list_locations: enumera/busca subcuentas desde una instalación de agencia/empresa conectada.

• ghl_list_installed_locations: enumera las ubicaciones donde esta aplicación está instalada/autorizada.

• ghl_connect_location: crea y almacena un token de Location a partir de una instalación de agencia/empresa.

• ghl_get_contact: recupera un contacto por su ID de contacto.

• ghl_search_contacts: busca contactos con /contacts/search.

• ghl_create_contact: crea un contacto; requiere confirm: true.

• ghl_update_contact: actualiza un contacto; requiere confirm: true.

• ghl_search_opportunities: busca oportunidades con /opportunities/search.

• ghl_api_call: llama a cualquier ruta relativa de la API de HighLevel; las llamadas que no sean GET requieren confirm: true.

MCP compartido de Google Ads para Claude

Para un MCP compartido de Google Ads que varias personas puedan usar en Claude, ejecuta el servidor oficial googleads/google-ads-mcp como un servicio remoto independiente en lugar de usar un proceso MCP stdio local.

Consulta docs/google-ads-mcp-claude.md para el despliegue en Cloud Run y la configuración del conector personalizado de Claude.

Herramientas

• gripp_list_entities: enumera las entidades de Gripp disponibles y los nombres de los métodos.

• gripp_describe_entity: inspecciona campos, valores de enumeración, referencias, métodos y ejemplos de una entidad.

• gripp_get: llama a <entity>.get con filtros y opciones.

• gripp_getone: llama a <entity>.getone con filtros.

• gripp_create: llama a <entity>.create; requiere confirm: true.

• gripp_update: llama a <entity>.update; requiere confirm: true.

• gripp_delete: llama a <entity>.delete; requiere confirm: true.

• gripp_call: llama a cualquier método documentado de Gripp por su nombre completo.

• gripp_batch: ejecuta varias llamadas documentadas de Gripp en una sola transacción.

Los métodos que no son de lectura se bloquean a menos que se proporcione confirm: true. Esto también se aplica a gripp_call y a cada elemento de gripp_batch.

Ejemplos

Buscar empresas por nombre:

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

Llamar a un método de lectura no estándar:

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

Crear una etiqueta:

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

Metadatos

La instantánea de metadatos incluida en el repositorio se genera a partir de la página pública de documentación de la API:

npm run fetch:metadata

Actualízala cuando Gripp actualice la documentación de la API.