Conectar tu asistente de IA con el servidor MCP
El servidor MCP deja que un asistente de IA compatible trabaje con tus datos de Faxtal: buscar facturas, validarlas o revisar incidencias. Antes de cada acción que no se puede deshacer, como emitir o anular, el asistente te enseña un resumen y espera tu confirmación.
Antes de empezar
- El servidor MCP depende de tu plan. Si no está incluido, verás «Esta función requiere un plan superior».
- Necesitas el rol Propietario o Admin.
- Ten a mano tu asistente de IA: Claude, ChatGPT, Cursor, VS Code, Codex o Gemini CLI.
Pasos
- Abre tu menú de usuario, pulsa Configuración y, en API e integraciones, pulsa Servidor MCP.
- Copia la URL del servidor MCP.
- Pulsa Generar API key. Se muestra una sola vez: cópiala antes de cerrar el aviso.
- En Cliente de IA, elige el tuyo. El código de ejemplo cambia con la elección y ya lleva tu URL y tu API key. Cópialo y pégalo donde indica Dónde pegarlo: un comando de terminal o un fichero de configuración, según el cliente.
- Reinicia el cliente si te lo pide y pídele algo sencillo, como «lista mis últimas facturas».
Con ChatGPT
ChatGPT no usa API key. Añade la URL como conector personalizado en sus ajustes y, cuando te lo pida, autoriza el acceso con tu cuenta de Faxtal.
Ver y revocar accesos
Cuando un asistente se conecta por autorización (OAuth), aparece en Clientes autorizados. Para quitarle el acceso, pulsa Revocar. Las API keys se gestionan en API Keys.
Qué pasa después
- El asistente solo ve y hace lo que permite la API key o la autorización, y siempre sobre la empresa activa.
- Los textos que devuelve Faxtal, como nombres de terceros o conceptos, son datos y no instrucciones para el asistente.
Problemas frecuentes
- No veo «Servidor MCP» o sale un plan bloqueado. Tu plan no lo incluye o no tienes el rol necesario.
- El asistente responde que no está autorizado. La API key está revocada o mal copiada. Genera una nueva y vuelve a pegar el código.
- Perdí la API key. No se puede volver a ver: genera otra y revoca la anterior en API Keys.
Para la lista de herramientas, recursos y permisos, consulta la referencia del servidor MCP.
Crear y gestionar API keys
Cómo crear una API key para conectar tus programas con la API de Faxtal, copiarla, rotarla y revocarla.
Revisar tus notificaciones
Qué avisos da Faxtal (certificados, VeriFactu, envíos a la AEAT, pagos, entregas, solicitudes), dónde se ven y cómo marcarlos como leídos o descartarlos.