Conecta tu IA a Afer
Afer incluye un servidor MCP (Model Context Protocol), el estándar abierto que usan los asistentes de IA para conectarse a otras aplicaciones. Conecta Claude, ChatGPT u otro asistente compatible a tu cuenta y pregúntale por tus ventas, tesorería, pendiente de cobro, stock o CRM en lenguaje natural. Sin exportar nada: el asistente consulta tus datos en tiempo real, siempre dentro de tu cuenta.
https://api.afer.pro/mcp/
Qué puedes preguntarle
Una vez conectado, tu asistente dispone de más de 30 herramientas de consulta y de acciones de CRM sobre tu cuenta. Ejemplos reales:
- «¿Cómo va el mes? Dame ventas, cobros y pendiente de cobro.»
- «¿Quién me debe dinero y desde cuándo? Ordena por antigüedad.»
- «Compara las ventas de este trimestre con el anterior, mes a mes.»
- «¿Qué previsión de pagos tengo para septiembre y octubre?»
- «¿Cómo está el pipeline del CRM? ¿Qué win rate llevamos este año?»
- «Crea una oportunidad en el funnel de ventas para maria@ejemplo.com y muévela a Propuesta.»
Conecta tu asistente
La conexión se hace una sola vez, desde los ajustes del asistente. Elige el tuyo y sigue la guía paso a paso:
Con tus claves API en las cabeceras, que es lo más directo cuando el cliente las admite (Claude Desktop, Claude Code, Cursor…), o con OAuth, donde te identificas en Afer y el asistente recibe su propio token sin que le pegues ninguna credencial. OAuth es la única vía para ChatGPT.
Claude
ChatGPT
Gemini, Copilot y másCredenciales: tus claves API
El servidor MCP usa las mismas claves API del resto de la API (cómo obtenerlas →): se generan en Afer → tu organización → Integraciones, disponibles en los planes Advanced y Premium con el extra de IA (Tier 1 o superior). Hay dos formas de enviarlas, según lo que permita tu cliente MCP:
X-API-KEY + X-API-SECRETdos cabeceras |
El mismo par que en el resto de la API. Para clientes que permiten varias cabeceras (Claude Code, Cursor, VS Code, mcp-remote, MCP Inspector…). |
Authorizationuna cabecera |
Credencial única para clientes que solo permiten una cabecera de autorización: Bearer afer_tk_….afer_sk_… — tu token y tu secret unidos por un punto. |
La dirección del servidor es https://api.afer.pro/mcp/,
con la barra al final. Algunos clientes MCP no siguen redirecciones,
así que cópiala tal cual.
Herramientas disponibles
Todas operan exclusivamente sobre la cuenta de la clave API con la que te conectas.
| Consultas e informeslectura | consultar_resumen, consultar_ventas, consultar_compras, consultar_resultado, consultar_facturas, consultar_facturas_compra, consultar_albaranes, consultar_stock, listar_clientes, listar_proveedores |
| Tesoreríalectura | consultar_cobros, consultar_pagos, consultar_pendiente_cobro, consultar_pendiente_pago, consultar_prevision_cobros, consultar_prevision_pagos, consultar_transacciones |
| Negocio recurrentelectura | consultar_mrr, consultar_recurrentes_creados, consultar_recurrentes_renovaciones, consultar_recurrentes_bajas |
| CRMlectura + acciones | consultar_crm, consultar_oportunidades, listar_funnels, listar_motivos_perdida · acciones: crear_contacto, crear_oportunidad, mover_oportunidad_etapa, cerrar_oportunidad |
| Charterslectura | listar_flota_charter, consultar_ocupacion_charter, consultar_disponibilidad_charter |
- La cuenta sobre la que se opera la determina siempre la clave API: el asistente no puede acceder a otra cuenta aunque lo pida.
- Las únicas acciones de escritura disponibles son las del CRM (contactos y oportunidades). El MCP no puede crear facturas ni documentos de venta.
- Revoca o rota la clave en cualquier momento desde Integraciones: la conexión deja de funcionar al instante.
- Recomendación: genera una clave API dedicada para cada asistente que conectes (p. ej. «Claude», «ChatGPT»), distinta de la de tus integraciones de servidor. Así puedes revocarlas por separado.
Probar la conexión
Con el conector activo, pídele a tu asistente: «¿Qué herramientas de Afer tienes disponibles?» y después «Dame el resumen del mes». Si responde con tus cifras, la conexión está viva. Ante un error de credenciales (401), revisa que el token y el secret estén completos y que la clave siga activa en Integraciones.