gtmos-mcp

Аудит CRM только для чтения для Claude: оцените целостность данных, найдите дублирующиеся кластеры и застрявшую выручку в вашей среде через собственный токен.

Сервер MCP (Model Context Protocol), который позволяет Claude Desktop, Claude Code или любому MCP-хосту аудировать ваш HubSpot CRM. Он работает в вашей среде, читает с помощью вашего собственного токена HubSpot, и ни один новый поставщик не касается ваших данных. Каждый инструмент по построению доступен только для чтения: ничего в этом пакете не записывает в CRM, не отправляет почту и не вызывает никаких сетевых API, кроме вашей собственной конечной точки HubSpot.

• Ноль зависимостей. Чистая стандартная библиотека Python (dependencies = []). Нечего проверять транзитивно.

• Только чтение. Два инструмента, оба аудита. На вашем токене не нужны права на запись.

• Детерминированная оценка. В пути оценки нет LLM; модель читает результаты, а не выдумывает их.

• Работает офлайн. Направьте инструменты на JSON-экспорт вместо живого портала, и сетевых вызовов не будет вообще.

Tools

Related MCP server: g-gremlin-hubspot-mcp

Install

Требуется Python 3.11+.

pip install git+https://github.com/Kai8karma/gtmos-mcp.git

Проверьте:

gtmos mcp --dry-run

Ожидаемый вывод:

[dry-run] gtmos mcp would serve 2 tools on stdio (protocol 2025-06-18)
  - audit_crm: Score a CRM export or live HubSpot portal for data-integrity leaks.
  - funnel_leak: Analyse deals by stage to find stalled pipeline and where revenue leaks out of the funnel.

Connect to Claude

Сгенерируйте блок конфигурации (всегда соответствует установленному коду):

gtmos mcp --config

Затем вставьте его в конфигурацию вашего MCP-хоста. Для Claude Desktop это ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "gtmos": {
      "command": "gtmos",
      "args": [
        "mcp"
      ],
      "env": {
        "GTMOS_HUBSPOT_TOKEN": "<your-hubspot-private-app-token>"
      }
    }
  }
}

Для Claude Code:

claude mcp add gtmos --env GTMOS_HUBSPOT_TOKEN=<your-hubspot-private-app-token> -- gtmos mcp

Перезапустите хост, затем спросите: «Проведи аудит моего CRM и покажи самое слабое измерение.»

Getting a HubSpot token

Создайте приватное приложение на вашем портале HubSpot с правами только на чтение: crm.objects.contacts.read для audit_crm, crm.objects.deals.read для funnel_leak. Токен остается в конфигурации вашего хоста на вашей машине; этот пакет никогда не сохраняет и не пересылает его.

No token? Use an export

Оба инструмента принимают файл вместо живого портала:

audit_crm  { "contacts_file": "./contacts.json", "acv": 9000 }
funnel_leak { "deals_file": "./deals.json" }

contacts.json — это JSON-массив объектов контактов (форма экспорта HubSpot: properties.email, properties.firstname, ...). Смотрите tests/fixtures/contacts_sample.json и tests/fixtures/deals_sample.json для точных форм.

What a run looks like

Scored 25 records.
Portal integrity score: 77.5 (B).
Duplicate clusters found: 2.
Dimension averages (worst first):
  - freshness: 55.0
  - ownership: 88.0
  - validity: 91.9
  - consistency: 93.6
  - completeness: 94.6
Full report written to: ./audit-out/integrity-report.md

CLI without MCP

Те же движки запускаются напрямую из оболочки:

gtmos audit --input contacts.json --acv 9000     # contact integrity audit
gtmos calibrate --scores s.json --outcomes o.json # grade the scorer against real outcomes

Architecture

JSON-RPC 2.0 с разделением строк через stdio, в соответствии с транспортом MCP stdio. Обработчик протокола (handle_message) — это чистая функция, сообщение на входе, ответ на выходе, поэтому всю поверхность можно тестировать без запуска процесса. Механизмы оценки детерминированы и не требуют сети; единственный сетевой код — это опциональный запрос к HubSpot с использованием вашего токена с вашей машины.

gtmos/
  mcp/        stdio server + tool definitions
  audit/      contact integrity engine, fetch, report
  funnel/     deal-stage leak engine, fetch, report
  calibrate/  scorer-vs-reality grading

Tests

python -m pytest tests/

59 тестов, все офлайн, токен не требуется.

License

MIT