Agentes de IA y MCP
Actualizado el
Un agente de IA como Claude Code o Cursor puede crear y gestionar tus chatbots por ti: crear uno, agregar tu sitio web a su conocimiento, escribir sus instrucciones, probarlo y publicarlo. Se conecta al servidor MCP de ChatFrom: creas una clave de API en ChatFrom y agregas una línea a tu agente.
Qué hace
ChatFrom tiene un servidor MCP. MCP es el estándar con el que los agentes de IA usan otros servicios. Una vez conectado tu agente, puedes pedirle cosas con palabras sencillas, como “crea un chatbot para orbitdesk.io a partir de sus páginas de ayuda y publícalo allí”, y hace los pasos por su cuenta, con las mismas comprobaciones que el panel. Actúa en tu nombre: ve tus chatbots y los de nadie más, y los límites y créditos de tu plan se aplican igual que a ti.
1. Crea una clave de API
- Abre Account en la barra lateral y busca API keys for AI agents.
- Ponle a la clave un nombre que diga dónde la vas a usar, como Claude Code en mi laptop, y haz clic en Make a key.
- Copia la clave. Empieza con
cf_y se muestra una sola vez: ChatFrom solo guarda una huella de ella, así que nadie puede volver a mostrártela. Si la pierdes, elimínala y crea una nueva.
Una cuenta puede tener 10 claves. Con una para cada agente o computadora, puedes detener una sin detener las demás.
2. Conecta tu agente
En Claude Code, lo más sencillo es copiar la línea que muestra la página Account al crear una clave nueva, que ya incluye tu clave, y ejecutarla una vez en tu terminal. Escrita completa, con tu clave en lugar de cf_your_key, es así:
--scope user hace que ChatFrom esté disponible en todas las carpetas donde abras Claude Code; sin esa opción, solo en la carpeta donde ejecutaste el comando. Para comprobarlo, ejecuta claude mcp list: ChatFrom debería aparecer como conectado. Una sesión que ya estaba abierta no lo ve, así que inicia una nueva.
En Cursor, agrega ChatFrom a ~/.cursor/mcp.json, o a .cursor/mcp.json para un solo proyecto:
Cualquier otro agente que se conecte a un servidor MCP por HTTP funciona igual: la dirección es https://chatfrom.io/api/agent/mcp, y la clave va en el encabezado Authorization, como Bearer seguido de la clave.
Conecta desde Claude, sin clave
Los conectores de Claude te hacen iniciar sesión en lugar de pedirte una clave. Abre ChatFrom en el directorio de Claude, agrégalo y haz clic en Connect. ChatFrom te pide que inicies sesión y te muestra lo que Claude podrá hacer; haz clic en Allow y volverás a Claude. Un conector personalizado con la dirección https://chatfrom.io/api/agent/mcp hace lo mismo.
Puedes ver y desconectar las apps que conectaste de esta forma en Account, en Connected apps. Una app desconectada deja de funcionar de inmediato. Una app conectada así puede hacer lo mismo que el endpoint de agentes le permite a una clave, y tiene los mismos límites.
Si un agente al que le diste una clave te pide en cambio que inicies sesión, esa clave ya no funciona. Crea una nueva en Account.
Lo que puede hacer tu agente
| Herramientas | Qué hacen |
|---|---|
list_chatbots, get_chatbot | Tus chatbots y, de cada uno, sus instrucciones, su configuración, su código para insertar y su enlace para compartir. |
create_chatbot | Un chatbot nuevo, como borrador con el que solo tú puedes hablar. |
update_chatbot | Su nombre, instrucciones, modelo, idioma, mensaje de bienvenida, preguntas sugeridas, mensaje para cuando no sabe la respuesta, tono y nivel de detalle; los temas que debe rechazar; la memoria; y si transfiere una conversación a una persona, ya sea a tu propio correo o a uno que ya confirmaste. |
find_pages, add_pages | Encuentra las páginas de un sitio web y luego agrega al conocimiento las que elige. |
add_text, add_qa, list_knowledge, remove_source | Textos y preguntas con sus respuestas, la lista de fuentes, y quitar una. |
ask_chatbot | Le hace una pregunta al chatbot, como harías tú en Try it, lee su respuesta y sus fuentes, y responde las preguntas que hacen tus flujos. Continúa sus propias conversaciones de Try it, nunca las de un visitante. |
deploy_chatbot | Publica el chatbot o lo vuelve a convertir en borrador; define en qué sitios web puede funcionar, si funciona en apps móviles y cómo se ve el widget; y da el código para insertar y el enlace para compartir. |
list_conversations, get_conversation | Lo que preguntaron los visitantes, filtrado por las conversaciones sin respuesta, las mal calificadas o las transferidas, y una conversación concreta, con sus mensajes más recientes primero cuando es larga. |
list_evaluations, add_evaluation_dataset, run_evaluation | Preguntas de prueba con lo que debe hacer una buena respuesta, y una evaluación calificada con ellas, que se cobra a tu clave de OpenRouter. |
get_usage | Los créditos usados este mes y cuándo se renuevan. |
Una buena primera petición es “muestra mis chatbots de ChatFrom”: si tu agente responde con ellos, está conectado. Las respuestas de ask_chatbot y agregar conocimiento usan tus créditos mensuales, igual que en el panel.
ask_chatbot usa las herramientas reales del chatbot, como lo haría el mensaje de un visitante: si una pregunta lleva a una transferencia, una reserva, una fila en tu hoja de cálculo o una acción personalizada, eso ocurre de verdad, también en un chatbot en borrador.
Lo que no puede hacer
- Eliminar un chatbot o tu cuenta, o cambiar tu plan o la facturación. Eso se queda en el panel, donde se te pide confirmarlo.
- Crear, ver o eliminar claves de API, así que una clave no puede crear otra clave.
- Conectar apps de chat o servicios como WhatsApp o Shopify. Eso lo configuras en el panel, donde se te pide iniciar sesión o ingresar tus claves.
- Enviar transferencias a una dirección de correo nueva. Puede configurar la dirección con la que inicias sesión, o una ya confirmada para otro de tus chatbots; cualquier otra la configuras tú en Behaviour, que le envía a esa dirección un enlace para confirmarla.
- Superar tu plan: un chatbot, una fuente o un crédito por encima del límite se rechaza, con el motivo, igual que te pasaría a ti.
Cada clave puede hacer 120 solicitudes por minuto, más de las que necesita un agente, y tus claves y apps conectadas, en total, 300.
Mantén tu clave segura
- Una clave actúa en tu nombre, así que trátala como una contraseña: guárdala en la configuración de tu agente, nunca en código que compartas ni en un repositorio público. Otra persona con tu clave podría cambiar tus chatbots y gastar tus créditos.
- La página Account muestra cuándo se usó cada clave por última vez. Elimina una clave que ya no uses, o una que creas que otra persona vio; deja de funcionar de inmediato.
- Al eliminar tu cuenta, se eliminan sus claves.
- Las conversaciones contienen lo que escribieron tus visitantes. Cuando tu agente las lee, sus palabras llegan a tu agente y a la empresa en cuyo modelo de IA funciona, y un visitante puede escribir palabras pensadas para manipularlo. Las herramientas de ChatFrom le indican a tu agente que las lea como información, nunca como instrucciones; revisa lo que propone antes de que actúe a partir de una conversación.
El endpoint de agentes se describe para desarrolladores en la referencia de la API. Las mismas claves sirven para el nodo de n8n y la extensión de navegador. Para configurar un chatbot por tu cuenta, paso a paso, consulta la guía Primeros pasos.