Gripp MCP

Model Context Protocol-Server für den Gripp-API-3.0-Endpunkt unter https://api.gripp.com/public/api3.php.

Die Gripp-API ist JSON-RPC-ähnlich: Anfragen werden als Batch-Array per POST gesendet, und das API-Token wird als Authorization: Bearer <token> übermittelt.

Einrichtung

npm install
npm run fetch:metadata
npm run build

Setzen Sie Ihr Gripp-API-Token, bevor Sie den Server starten:

export GRIPP_API_TOKEN="your-token"
npm start

Optionale Umgebungsvariablen:

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

GRIPP_API_URL ist absichtlich auf den Host https://api.gripp.com/ beschränkt.

Related MCP server: SuperOps MCP Server

MCP-Client-Konfiguration

Beispiel für eine stdio-Konfiguration:

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

Nachdem Sie das Paket veröffentlicht oder verlinkt haben, können Sie auch die Binärdatei gripp-mcp ausführen.

Vercel Remote MCP

Dieses Repository stellt außerdem einen Streamable-HTTP-MCP-Endpunkt für Vercel über eine Next.js-Route bereit:

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

Für benutzerdefinierte Claude-Connectors verwenden Sie die URL /api/mcp. Die Stamm-URL gibt nur eine Health-Antwort zurück.

Setzen Sie diese Umgebungsvariable in Vercel, bevor Sie Gripp-Tools verwenden:

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

Verwenden Sie den Zugriffsschlüssel in der URL des benutzerdefinierten Connectors von Claude:

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

Der Endpunkt /api/mcp schließt in der Produktion fehl, wenn MCP_ACCESS_KEY nicht gesetzt ist. Falls die URL durchsickert, rotieren Sie MCP_ACCESS_KEY in Vercel und stellen Sie erneut bereit.

Der Remote-Endpunkt kann auch ein Gripp-Token aus Authorization: Bearer <token> oder x-gripp-api-token lesen, aber die Benutzeroberfläche des benutzerdefinierten Connectors von Claude bietet derzeit kein einfaches Feld für benutzerdefinierte Header. Für Claude besteht die praktische Einrichtung darin, GRIPP_API_TOKEN in der Vercel-Projektumgebung zu speichern.

GoHighLevel Remote MCP

Dasselbe Vercel-Projekt kann auch einen GoHighLevel-MCP-Endpunkt mit OAuth-Token-Speicherung hosten:

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

Setzen Sie diese Umgebungsvariablen in 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 und UPSTASH_REDIS_REST_TOKEN funktionieren ebenfalls anstelle der KV_*-Namen.

Fügen Sie in den App-Einstellungen des HighLevel-Marketplace diese Redirect-URL hinzu:

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

Öffnen Sie dann die OAuth-Start-URL in Ihrem Browser:

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

Nachdem HighLevel zurückgeleitet hat, speichert die Callback-Seite diese Subaccount-Installation. Verwenden Sie eine gemeinsame URL im Bildschirm des benutzerdefinierten Connectors von Claude:

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

Installieren Sie die App einmal pro Subaccount, indem Sie /api/connect/start erneut öffnen und den nächsten Standort auswählen. Der MCP führt einen Index aller verbundenen Installationen. Rufen Sie in Claude zuerst ghl_list_installations auf und übergeben Sie dann die gewählte installId an die Kontakt-, Opportunity- oder generischen API-Tools.

Wenn Ihre Marketplace-App nur von einem Agentur-Administrator installiert werden kann, setzen Sie GHL_OAUTH_USER_TYPE=Company. Nach der einmaligen Installation auf Agenturebene verwenden Sie ghl_list_installed_locations, um zu sehen, wo die App tatsächlich installiert ist, und dann ghl_connect_location, um eine gespeicherte Location-Installation für den Subaccount zu erstellen, den Sie abfragen möchten. ghl_list_locations listet nur sichtbare Subaccounts auf und beweist nicht, dass die App auf ihnen installiert ist.

Der GoHighLevel-MCP schließt in der Produktion fehl, wenn GHL_MCP_ACCESS_KEY, verschlüsselter Token-Speicher oder OAuth-Anmeldedaten fehlen.

GoHighLevel-Tools

• ghl_installation_status: zeigt die OAuth-Installationsmetadaten an, ohne Tokens preiszugeben.

• ghl_list_installations: listet alle verbundenen Subaccounts/Installationen auf.

• ghl_list_locations: listet/durchsucht Subaccounts aus einer verbundenen Agentur-/Firmeninstallation.

• ghl_list_installed_locations: listet Standorte auf, an denen diese App installiert/authorisiert ist.

• ghl_connect_location: erstellt und speichert ein Location-Token aus einer Agentur-/Firmeninstallation.

• ghl_get_contact: ruft einen Kontakt anhand der Kontakt-ID ab.

• ghl_search_contacts: durchsucht Kontakte mit /contacts/search.

• ghl_create_contact: erstellt einen Kontakt; erfordert confirm: true.

• ghl_update_contact: aktualisiert einen Kontakt; erfordert confirm: true.

• ghl_search_opportunities: durchsucht Opportunities mit /opportunities/search.

• ghl_api_call: ruft einen beliebigen relativen HighLevel-API-Pfad auf; Nicht-GET-Aufrufe erfordern confirm: true.

Gemeinsamer Google-Ads-MCP für Claude

Für einen gemeinsamen Google-Ads-MCP, den mehrere Personen in Claude verwenden können, führen Sie den offiziellen googleads/google-ads-mcp-Server als separaten Remote-Dienst aus, anstatt einen lokalen stdio-MCP-Prozess zu verwenden.

Siehe docs/google-ads-mcp-claude.md für die Cloud-Run-Bereitstellung und die Einrichtung des benutzerdefinierten Connectors in Claude.

Tools

• gripp_list_entities: listet verfügbare Gripp-Entitäten und Methodennamen auf.

• gripp_describe_entity: untersucht Felder, Enum-Werte, Referenzen, Methoden und Beispiele für eine Entität.

• gripp_get: ruft <entity>.get mit Filtern und Optionen auf.

• gripp_getone: ruft <entity>.getone mit Filtern auf.

• gripp_create: ruft <entity>.create auf; erfordert confirm: true.

• gripp_update: ruft <entity>.update auf; erfordert confirm: true.

• gripp_delete: ruft <entity>.delete auf; erfordert confirm: true.

• gripp_call: ruft eine beliebige dokumentierte Gripp-Methode mit vollständigem Namen auf.

• gripp_batch: führt mehrere dokumentierte Gripp-Aufrufe in einer Transaktion aus.

Nicht-Lese-Methoden werden blockiert, es sei denn, confirm: true wird angegeben. Dies gilt auch für gripp_call und jedes Element in gripp_batch.

Beispiele

Unternehmen nach Namen finden:

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

Eine nicht standardmäßige Lesemethode aufrufen:

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

Ein Tag erstellen:

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

Metadaten

Der committete Metadaten-Snapshot wird aus der öffentlichen API-Dokumentationsseite generiert:

npm run fetch:metadata

Aktualisieren Sie ihn, wenn Gripp die API-Dokumentation aktualisiert.