Gripp MCP

Сервер Model Context Protocol для конечной точки Gripp API 3.0 по адресу https://api.gripp.com/public/api3.php.

API Gripp похоже на JSON-RPC: запросы отправляются методом POST в виде массива batch, а токен API передается как Authorization: Bearer <token>.

Настройка

npm install
npm run fetch:metadata
npm run build

Установите токен API Gripp перед запуском сервера:

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.

Удаленный MCP на Vercel

Этот репозиторий также предоставляет конечную точку Streamable HTTP MCP для Vercel через маршрут Next.js:

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

Для пользовательских коннекторов Claude используйте URL /api/mcp. Корневой URL возвращает только ответ о состоянии.

Установите эту переменную окружения в Vercel перед использованием инструментов Gripp:

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

Используйте ключ доступа в URL пользовательского коннектора Claude:

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

Конечная точка /api/mcp в производственной среде закрывается при ошибке, если MCP_ACCESS_KEY не установлен. Если URL утёк, смените MCP_ACCESS_KEY в Vercel и выполните повторное развертывание.

Удаленная конечная точка также может читать токен Gripp из Authorization: Bearer <token> или x-gripp-api-token, но пользовательский интерфейс коннектора Claude в настоящее время не предоставляет простого поля для пользовательских заголовков. Для Claude практичная настройка — хранить GRIPP_API_TOKEN в окружении проекта Vercel.

Удаленный MCP для GoHighLevel

Тот же проект Vercel может также размещать конечную точку GoHighLevel MCP с хранением токенов OAuth:

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

Затем откройте стартовый URL OAuth в браузере:

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

После того как HighLevel перенаправит обратно, страница обратного вызова сохраняет установку этого субакаунта. Используйте один общий URL в окне пользовательского коннектора Claude:

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

Устанавливайте приложение один раз для каждого субакаунта, повторно открывая /api/connect/start и выбирая следующее местоположение. 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: получить один контакт по идентификатору контакта.

• ghl_search_contacts: искать контакты с помощью /contacts/search.

• ghl_create_contact: создать контакт; требует confirm: true.

• ghl_update_contact: обновить контакт; требует confirm: true.

• ghl_search_opportunities: искать возможности с помощью /opportunities/search.

• ghl_api_call: вызвать любой относительный путь API HighLevel; вызовы, отличные от GET, требуют confirm: true.

Общий Google Ads MCP для Claude

Для общего Google Ads MCP, который могут использовать несколько человек в Claude, запустите официальный сервер googleads/google-ads-mcp как отдельный удаленный сервис вместо использования локального процесса stdio MCP.

См. docs/google-ads-mcp-claude.md для развертывания Cloud Run и настройки пользовательского коннектора Claude.

Инструменты

• 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.