amoCRM über MCP mit Gemini verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → amoCRM klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

amoCRM + Gemini

Lass deine KI in amoCRM arbeiten: Deals in allen Pipelines finden und aktualisieren, Kontakte und Unternehmen nachschlagen, Aufgaben, Notizen und das Ereignisprotokoll lesen und neue Aufgaben und Notizen anlegen. Für Konten auf amocrm.ru, mit einem langlebigen Token aus einer Integration in deinem Konto.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

AMOCRM_SUBDOMAIN, AMOCRM_ACCESS_TOKEN

Schritt 1 — Zugangsdaten holen

1. Öffne in amoCRM im linken Menü амоМаркет (amoMarket), klicke oben rechts auf ⋯ (neben + WEB HOOKS) und wähle Создать интеграцию (Integration erstellen) und dann Внешняя интеграция (externe Integration). Dafür musst du Administrator des Kontos sein.
2. Gib eine Ссылка для перенаправления (Weiterleitungs-URL) ein: Das Formular verlangt eine, der langlebige Token nutzt sie aber nie, also reicht jede https-Adresse von dir. Hake unter Предоставить доступ die gewünschten Zugriffe an, gib der Integration einen Namen und eine Beschreibung und klicke auf Сохранить (Speichern).
3. Öffne in der Integration den Tab Ключи и доступы (Schlüssel und Zugriffe) und klicke auf Сгенерировать токен (Token erzeugen). Wähle ein Ablaufdatum zwischen 1 Tag und 5 Jahren und kopiere den Token sofort: amoCRM zeigt ihn nur einmal an.
4. Trage den Token in AMOCRM_ACCESS_TOKEN und die Subdomain deines Kontos in AMOCRM_SUBDOMAIN ein: Für https://acme.amocrm.ru trägst du acme ein. Dann installiere den Connector.
5. Beginne mit amocrm_get_account: Das Tool zeigt das Konto, seine Währung und seine Aufgabentypen.

amoCRM oder Kommo: Beides ist dasselbe Produkt. Konten unter <subdomain>.amocrm.ru nutzen diesen Connector; die alten internationalen Adressen <subdomain>.amocrm.com leiten dorthin weiter, du trägst also dieselbe Subdomain ein. Konten unter <subdomain>.kommo.com nutzen den Kommo-Connector.

Wessen Token: Der Token handelt als der Administrator, der ihn erstellt hat. Widerrufen kannst du ihn im Tab Выданные доступы der Integration mit Отозвать доступ. Wenn er abläuft, erzeugst du einen neuen und trägst ihn ein.

Erst bestätigen: Bevor die KI einen Deal anlegt oder ändert, einen Kontakt oder eine Aufgabe anlegt oder eine Notiz hinzufügt, zeigt sie dir, was sie schreiben wird, und wartet auf dein Ja. amoCRM prüft neue Kontakte nicht auf Dubletten, deshalb sucht die KI vorher.

Nur lesen: amoCRM-Tokens lassen sich nicht auf Lesen beschränken, deaktiviere deshalb amocrm_create_lead, amocrm_update_lead, amocrm_create_contact, amocrm_create_task und amocrm_add_note. Nichts in diesem Connector löscht Daten.

Pipelines, Phasen und Felder: Deals heißen in der API Leads. Jeder Deal steht in einer Phase einer Pipeline, und amocrm_list_pipelines listet sie auf. In jeder Pipeline ist Phase 142 Closed-won (Успешно реализовано) und 143 Closed-lost (Закрыто и не реализовано). Telefonnummern, E-Mail-Adressen und alle anderen Zusatzdaten sind benutzerdefinierte Felder; amocrm_list_custom_fields listet sie mit ihren IDs und Optionen auf. Die verantwortlichen Benutzer liefert amocrm_list_users.

Notizen und Ereignisprotokoll: amocrm_list_notes liest den Verlauf eines einzelnen Deals, Kontakts oder Unternehmens. amocrm_list_notes_by_type liest Notizen über alle Datensätze hinweg auf einmal, zum Beispiel alle Anrufe, die diese Woche protokolliert wurden. amocrm_list_events liest das Ereignisprotokoll des Kontos: Phasenwechsel, neue Datensätze, geänderte Felder und Verantwortliche, Anrufe, Chatnachrichten und erledigte Aufgaben, jeweils mit altem und neuem Wert.

Limits: höchstens 7 Anfragen pro Sekunde je Integration und 50 je Konto. Darüber antwortet amoCRM mit 429, und wiederholte Verstöße sperren den API-Zugang des Kontos, sodass jeder Aufruf mit 403 endet. Bitte die KI, zu filtern oder zu suchen, statt alle Deals oder Ereignisse Seite für Seite durchzugehen.

Häufige Fehler: 401 heißt, dass der Token falsch, abgelaufen oder widerrufen ist oder dass es auf amocrm.ru kein Konto mit dieser Subdomain gibt (ein kommo.com-Konto braucht den Kommo-Connector). 402 heißt, dass das Abonnement abgelaufen ist: Schreibzugriffe stoppen sofort, Lesezugriffe 30 Tage später. 403 kann heißen, dass dem Benutzer des Tokens Rechte fehlen oder dass der API-Zugang nach zu vielen Anfragen gesperrt wurde. 404 heißt, dass die ID oder die Subdomain falsch ist. 400 listet die ungültigen Felder auf, zum Beispiel eine Phase, die nicht zur Pipeline gehört, oder einen Wert vom falschen Typ in einem benutzerdefinierten Feld.

Der Connector löscht nichts und unterstützt keine Kunden (покупатели), keine eingehenden (unsortierten) Leads, Chats und Nachrichten, Listen (Kataloge), Webhooks oder Salesbot.

Schritt 2 — Adapter installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Schritt 3 — Connector in Gemini hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte gemini neu.
3. Führe in der Gemini CLI /mcp aus (oder gemini mcp list im Terminal): anythingmcp sollte als verbunden erscheinen.
4. Leg los: Gemini CLI kann jetzt die amoCRM-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Welche Deals in der Pipeline Vertrieb stehen in der Phase Verhandlung, und wer ist jeweils verantwortlich?“
• „Wer hat diese Woche Deals auf Closed-lost gesetzt, und wie viel waren diese Deals wert?“
• „Zeig mir alle eingehenden Anrufe, die seit Montag protokolliert wurden, und die Deals, zu denen sie gehören.“
• „Setz den Deal ‚Lagerregale für Stroymarket‘ auf Closed-won und leg für Montag eine Nachfass-Aufgabe für den verantwortlichen Manager an.“

FAQ

Wo sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden