@theyahia/amocrm-mcp

Servidor MCP de nivel de producción para la API de amoCRM. 19 herramientas que cubren leads, contactos, empresas, pipelines, tareas, notas, búsqueda, eventos y leads no clasificados. OAuth 2.0 con renovación automática del token. Limitación de peticiones (7 peticiones/seg). Reintento con retroceso exponencial.

Instalación

npx -y @theyahia/amocrm-mcp

Related MCP server: amocrm-mcp

Configuración de MCP

Añade esto a la configuración de tu Claude Desktop, Cursor o de cualquier cliente MCP:

{
  "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"
      }
    }
  }
}

Variables de entorno

AMOCRM_DOMAIN también se acepta como alias de AMOCRM_SUBDOMAIN (por compatibilidad con versiones anteriores).

Herramientas (19)

Leads

Contactos

Empresas

Pipelines

Tareas

Sin clasificar

Notas

Búsqueda

Eventos

Cuenta

Prompts de demostración

Resumen de ventas:

"Muéstrame todos los leads del pipeline 'Ventas' que estén actualmente en la etapa 'Negociación'. Incluye la información de contacto."

Gestión de tareas:

"Crea una tarea de llamada de seguimiento para el lead #12345, con fecha límite mañana a las 10:00. Luego lista todas mis tareas sin completar."

Incorporación de nuevos clientes:

"Crea un contacto 'Ivan Petrov' con el teléfono +79001234567, luego crea una empresa 'Petrov Solutions' y un lead 'Desarrollo web' por 150 000 RUB en el pipeline principal."

Guía de configuración de OAuth 2.0

1. Ve a la configuración de tu cuenta de amoCRM: https://YOUR_SUBDOMAIN.amocrm.ru/settings/widgets/

2. Crea una nueva integración (integración externa)

3. Establece la URI de redirección en https://YOUR_SUBDOMAIN.amocrm.ru

4. Copia el Client ID y el Client Secret

5. Autoriza la integración para obtener el Authorization Code inicial

6. Intercambia el código por los tokens:

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. Guarda el access_token y el refresh_token de la respuesta

8. El servidor renovará automáticamente los tokens caducados si se definen AMOCRM_REFRESH_TOKEN, AMOCRM_CLIENT_ID y AMOCRM_CLIENT_SECRET

Manejo de errores

• 401 No autorizado: Renueva automáticamente el token si las credenciales de renovación están configuradas y, a continuación, reintenta.

• 429 Límite de peticiones superado: Respeta la cabecera Retry-After, espera y reintenta.

• Errores 5xx del servidor: Reintento con retroceso exponencial (hasta 3 intentos).

• Limitación de peticiones: Retardo integrado de 150 ms entre peticiones (~7 peticiones/seg) para mantenerse dentro de los límites de amoCRM.

Desarrollo

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

Licencia

MIT