Una API (Interfaz de Programación de Aplicaciones) es como un puente que permite que tu sitio web o aplicación se comunique con tu agente.
🎯 Ejemplo del mundo real:
Imagina que tienes un restaurante. El mesero es la API: lleva los pedidos de los clientes a la cocina (tu agente) y trae las respuestas (los platos). Los clientes no necesitan ir a la cocina directamente, el mesero hace la conexión.
Tu sitio web → API → Tu agente → API → Respuesta en tu sitio
Una clave API es como una contraseña especial que le das a tu sitio web para que pueda usar tu agente. Sin esta clave, nadie puede acceder al agente, manteniéndolo seguro.
Crear una nueva clave API:
Ve a la pestaña "API"
En la configuración de tu agente, selecciona la cuarta pestaña.
Haz clic en "Generar Clave"
Se abrirá un formulario para configurar la clave.
Dale un nombre descriptivo
Ejemplo: "Sitio Web Principal" o "App Móvil".
Selecciona el tiempo de vida
Cuánto tiempo será válida la clave:
- • Permanente: nunca expira (más conveniente).
- • 1 año: expira en un año (más seguro).
- • 1 mes: para pruebas temporales.
- • 1 semana: para demos o pruebas cortas.
Genera y copia la clave
Se verá algo así:
⚠️ MUY IMPORTANTE: Copia y guarda la clave inmediatamente. Solo se muestra UNA vez. Si la pierdes, tendrás que crear una nueva.
Seguridad de las claves API
- • Nunca compartas tu clave API públicamente (redes sociales, GitHub público, etc.).
- • Guárdala en un lugar seguro (administrador de contraseñas).
- • Si crees que tu clave fue comprometida, revócala inmediatamente.
- • Usa claves diferentes para diferentes proyectos.
Cada agente tiene URLs especiales (endpoints) que usas para enviarle mensajes y recibir respuestas.
MCP Streamable HTTP
Transporte HTTP con streaming para comunicación bidireccional con el agente.
💡 Úsalo para: MCP Inspector, clientes MCP, integraciones con streaming.
MCP SSE (Server-Sent Events)
Transporte SSE para recibir respuestas en tiempo real del agente.
💡 Úsalo para: conexiones de larga duración, streaming de respuestas en tiempo real.
📋 ¿Dónde encuentro mis endpoints?
En la pestaña "API" de tu agente encontrarás ambos endpoints listos para copiar. Solo necesitas añadir tu clave API al usarlos.
Si tienes un desarrollador web, puede usar este código como ejemplo para conectar el agente a tu sitio.
// JavaScript - Enviar mensaje al agente via MCP
const response = await fetch(
'https://tu-dominio.com/api/mcp/agents/{agent_id}/stream-http',
{
method: 'POST',
headers: {
'Authorization': 'Bearer tu_api_key_aqui',
'Content-Type': 'application/json',
'Accept': 'application/json'
},
body: JSON.stringify({
jsonrpc: '2.0',
id: 1,
method: 'tools/call',
params: {
name: 'send_message',
arguments: { message: '¿Cuál es el precio del producto X?' }
}
})
}
);
// Leer respuesta NDJSON
const reader = response.body.getReader();
const decoder = new TextDecoder();
let result = '';
while (true) {
const { done, value } = await reader.read();
if (done) break;
result += decoder.decode(value);
}
console.log(JSON.parse(result)); // Respuesta del agente💡 Nota para no programadores:
No te preocupes si este código no tiene sentido. Simplemente muéstraselo a tu desarrollador web junto con tu clave API y ellos sabrán qué hacer. También puedes contratar desarrollo en plataformas como Fiverr o Upwork.
En la tabla de claves API puedes ver todas tus claves activas y su información:
🚫 Revocar una clave
Si necesitas desactivar una clave (por seguridad o porque ya no la usas), haz clic en el botón "Revocar" en la fila de esa clave. La clave dejará de funcionar inmediatamente. Esta acción no se puede deshacer.