@theyahia/amocrm-mcp

Produktionsreifer MCP-Server für die amoCRM API. 19 Tools für Leads, Kontakte, Unternehmen, Pipelines, Aufgaben, Notizen, Suche, Ereignisse und unsortierte Leads. OAuth 2.0 mit automatischer Token-Aktualisierung. Ratenbegrenzung (7 Anfragen/Sek.). Wiederholung mit exponentiellem Backoff.

Installation

npx -y @theyahia/amocrm-mcp

Related MCP server: amocrm-mcp

MCP-Konfiguration

Fügen Sie dies zu Ihrer Claude Desktop-, Cursor- oder einer beliebigen MCP-Client-Konfiguration hinzu:

{
  "mcpServers": {
    "amocrm": {
      "command": "npx",
      "args": ["-y", "@theyahia/amocrm-mcp"],
      "env": {
        "AMOCRM_SUBDOMAIN": "mycompany",
        "AMOCRM_ACCESS_TOKEN": "your-access-token",
        "AMOCRM_REFRESH_TOKEN": "your-refresh-token",
        "AMOCRM_CLIENT_ID": "your-client-id",
        "AMOCRM_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Umgebungsvariablen

AMOCRM_DOMAIN wird ebenfalls als Alias für AMOCRM_SUBDOMAIN akzeptiert (Abwärtskompatibilität).

Tools (19)

Leads

Kontakte

Unternehmen

Pipelines

Aufgaben

Unsortierte

Notizen

Suche

Ereignisse

Konto

Demo-Prompts

Vertriebsübersicht:

„Zeig mir alle Leads in der Pipeline ‚Vertrieb‘, die sich aktuell in der Phase ‚Verhandlung‘ befinden. Inklusive Kontaktinformationen.“

Aufgabenverwaltung:

„Erstelle eine Folgeanruf-Aufgabe für Lead #12345, Frist morgen um 10:00 Uhr. Danach liste alle meine unerledigten Aufgaben auf.“

Neukunden-Onboarding:

„Erstelle einen Kontakt ‚Ivan Petrov‘ mit Telefon +79001234567, erstelle dann ein Unternehmen ‚Petrov Solutions‘ und ein Lead ‚Website Development‘ für 150.000 RUB in der Haupt-Pipeline.“

OAuth-2.0-Einrichtungsanleitung

1. Rufen Sie die Einstellungen Ihres amoCRM-Kontos auf: https://YOUR_SUBDOMAIN.amocrm.ru/settings/widgets/

2. Erstellen Sie eine neue Integration (externe Integration)

3. Setzen Sie die Redirect-URI auf https://YOUR_SUBDOMAIN.amocrm.ru

4. Kopieren Sie die Client ID und das Client Secret

5. Autorisieren Sie die Integration, um den anfänglichen Autorisierungscode zu erhalten.

6. Tauschen Sie den Code gegen Tokens ein:

curl -X POST https://YOUR_SUBDOMAIN.amocrm.ru/oauth2/access_token \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "YOUR_CLIENT_ID",
    "client_secret": "YOUR_CLIENT_SECRET",
    "grant_type": "authorization_code",
    "code": "YOUR_AUTH_CODE",
    "redirect_uri": "https://YOUR_SUBDOMAIN.amocrm.ru"
  }'

7. Speichern Sie access_token und refresh_token aus der Antwort.

8. Der Server aktualisiert abgelaufene Tokens automatisch, wenn AMOCRM_REFRESH_TOKEN, AMOCRM_CLIENT_ID und AMOCRM_CLIENT_SECRET gesetzt sind.

Fehlerbehandlung

• 401 Nicht autorisiert: Aktualisiert das Token automatisch, wenn Aktualisierungsdaten konfiguriert sind, und versucht es dann erneut.

• 429 Ratenlimit: Beachtet den Retry-After-Header, wartet und versucht es erneut.

• 5xx-Serverfehler: Wiederholung mit exponentiellem Backoff (bis zu 3 Versuche).

• Ratenbegrenzung: Integrierte Verzögerung von 150 ms zwischen Anfragen (~7 Anfragen/Sek.), um innerhalb der amoCRM-Limits zu bleiben.

Entwicklung

git clone https://github.com/theYahia/amocrm-mcp.git
cd amocrm-mcp
npm install
npm run build
npm test

Lizenz

MIT