CRMamoCRM

Instala la CLI y el servidor MCP de amoCRM

Instala la CLI de amoCRM con npm, crea una integración privada e inicia sesión con un token o en el navegador.

Conecta tu cuenta de amoCRM o Kommo una vez, y desde entonces tu agente de IA puede leer y actualizar tus negociaciones. El CRM guarda tus negociaciones, contactos y empresas en la nube, y solo deja entrar a un programa a través de una integración privada que crea un administrador de la cuenta.

Después tu agente te dice qué negociaciones están abiertas, pasa una negociación a la siguiente etapa o encuentra a un cliente, desde una terminal o por MCP, hasta donde lo permiten los permisos que pongas. Tú ejecutas los mismos comandos, o desde un script.

amo es una herramienta de línea de comandos de WireCat, un programa que tú o tu agente ejecutáis por su nombre. Lo conectas una vez por cuenta, y amo work setup hace cada pregunta por turno. Una sola integración privada sirve para las dos formas de iniciar sesión: un token que pegas o un inicio de sesión en el navegador. El único requisito es un administrador de la cuenta, que crea la integración.

En esta página:

  1. Instala
  2. Crea la integración
  3. Inicia sesión con una clave
  4. Inicia sesión con la integración
  5. Cuál elegir
  6. Conecta paso a paso
  7. Cierra la sesión y retira el acceso
  8. Siguiente: la primera sincronización

Instala

Instala amo una vez en cada ordenador donde lo uses tú o un agente. Necesitas Node.js 22.16 o un 22.x posterior, o 24 o posterior. Node 23 no está soportado.

npm install -g @wirecat/amo-cli
amo --version
amo skill install   # the agent skill, for Claude Code, Codex, Gemini CLI and OpenClaw
amo doctor

Un agente sin terminal, como Claude Desktop, usa amo por MCP. amo doctor no usa la red ni abre el llavero. Muestra la versión, dónde están los ajustes, qué perfiles existen y si otros usuarios del ordenador pueden leer los ajustes.

Crea la integración

Lo hace un administrador de la cuenta, una vez. La misma integración sirve para la clave y para el inicio de sesión en el navegador.

En amoCRM (<subdomain>.amocrm.ru):

  1. Abre амоМаркет, pulsa ⋯ arriba a la izquierda y elige «Создать интеграцию» (crear integración).
  2. Dale un nombre y una descripción, como WireCat.
  3. En «Ссылка для перенаправления» (la Redirect URI), escribe https://wirecat.dev/webhooks/apps/amo-callback. La clave no la usa, pero con ella la misma integración sirve también para iniciar sesión en el navegador.
  4. En «Предоставить доступ», marca «Доступ к данным аккаунта» (acceso a los datos de la cuenta).
  5. Deja sin marcar «Контроль дублей» y «Множественные источники», y guarda.

En una cuenta que no está marcada como técnica, amoCRM pide primero firmar una renuncia al soporte técnico para una integración privada. Después, el soporte de amoCRM deja de aceptar avisos de errores del sistema en la cuenta, y la renuncia no se puede retirar. Léela antes de firmar (amoCRM: integraciones, amoCRM: paso a paso).

En Kommo (<subdomain>.kommo.com o <subdomain>.amocrm.com): Settings → Integrations → Create integration. Rellena el nombre, la descripción y la misma Redirect URL. Allow access tiene todos los permisos marcados por defecto. Deja sin marcar Duplicate control y Multiple sources, y guarda. Kommo no pide ninguna renuncia (Kommo: integración privada).

Inicia sesión con una clave

La clave es el token de larga duración de amoCRM. Actúa con los permisos del administrador que la creó.

  1. En la integración, abre la pestaña «Ключи» (en Kommo, Keys and scopes) y pulsa «Сгенерировать токен» (en Kommo, Generate long-lived token).

  2. Elige una fecha de fin, de un día a cinco años.

  3. Copia el token. Solo se muestra una vez (amoCRM: paso a paso, Kommo: token de larga duración).

  4. Elige un nombre de perfil para esta cuenta, como work. Ejecuta los comandos de abajo con la dirección de tu cuenta en lugar del ejemplo https://example.amocrm.ru, y pega el token cuando amo lo pida:

    amo work session start --host https://example.amocrm.ru
    amo work session status --check

session start lee el token sin mostrarlo, o desde stdin. Lo comprueba con la cuenta y solo entonces lo guarda en el llavero del sistema junto con la dirección. Con --credential-storage file lo guarda en un archivo privado. session status --check muestra la cuenta y el usuario con el que actúa el token. La dirección se queda tal como la escribes: <subdomain>.amocrm.ru, <subdomain>.kommo.com o <subdomain>.amocrm.com.

Inicia sesión con la integración

Este inicio de sesión usa OAuth: permites la integración en el navegador, y cada persona actúa con sus propios permisos.

  1. En la pestaña «Ключи» de la integración (en Kommo, Keys and scopes), copia el ID de la integración. Ten también a mano la clave secreta.

  2. Ejecuta el comando de abajo con tu dirección y tu ID de integración en lugar de los ejemplos https://example.amocrm.ru y 0123abcd-4567-89ef-0123-456789abcdef:

    amo work session start --host https://example.amocrm.ru --client-id 0123abcd-4567-89ef-0123-456789abcdef
  3. Pega la clave secreta cuando amo la pida. No se muestra. También puede darla AMO_AMOCRM_CLIENT_SECRET.

  4. El navegador abre amoCRM. Elige la cuenta y pulsa «Разрешить» (permitir).

amo guarda los tokens y renueva el token de acceso por sí mismo. La Redirect URI de la integración debe ser https://wirecat.dev/webhooks/apps/amo-callback. Un inicio de sesión nuevo de cualquier tipo sustituye al otro del perfil.

Cuál elegir

  • La clave es lo más sencillo: pegarla una vez y sin navegador. Actúa como el administrador que la creó y deja de funcionar en su fecha de fin. Entonces creas otra y vuelves a ejecutar session start.
  • El inicio de sesión con la integración actúa como la persona que entra y no tiene fecha de fin que vigilar. El refresh token de amoCRM dura 3 meses, y amo recibe uno nuevo cada vez que renueva el token de acceso. Así sigue funcionando mientras amo se ejecute al menos una vez cada 3 meses. Tras una pausa más larga, vuelve a iniciar sesión (amoCRM: paso a paso).

Conecta paso a paso

amo work setup hace las preguntas una a una, comprueba las respuestas y solo las guarda si la comprobación sale bien:

  1. ¿Qué cuenta? La dirección en la que abres el CRM.
  2. Crea una integración privada. Los pasos de crea la integración.
  3. Crea el token. Pega la clave de la pestaña «Ключи».
  4. Comprobando el token. amo pregunta a la cuenta de quién es el token, y guarda la dirección y el token solo si la cuenta responde. Un token rechazado te devuelve al paso del token.
  5. Conectado. El perfil está listo.

Inicia sesión con la clave. El inicio de sesión en el navegador es el comando que aparece en Advanced en el último paso.

Cierra la sesión y retira el acceso

amo work session end olvida el inicio de sesión en este ordenador. amo work account remove --keep-data olvida el inicio de sesión y los archivos del perfil, y --delete-data además borra la copia de la cuenta del almacén de WireCat.

Ninguno de los dos avisa a amoCRM. Para detener una clave en la propia cuenta, por ejemplo tras una filtración, abre la pestaña «Выданные доступы» de la integración y pulsa «Отозвать доступ» (amoCRM: paso a paso). En Kommo es la pestaña Authorization → Revoke access (Kommo: token de larga duración).

Siguiente: la primera sincronización

Copia tus negociaciones y sus clientes en WireCat, y luego lista las abiertas:

amo work sync
amo work deals list status:open

Más en la primera sincronización.