Documentación

Inicio rápido

Todo ocurre en la consola web: regístrate, haz clic en «Nuevo proyecto» y sigue los tres pasos. No se necesita ninguna clave API.

1. Importa tu API

   Aporta una URL de especificación OpenAPI, un comando curl o una colección de Postman — Invokera la convierte en herramientas MCP tipadas.

2. Verifica la propiedad del dominio

   Demuestra que el dominio de la API es tuyo con un registro DNS TXT o un archivo well-known.

3. Publica

   Al entrar en producción, tu proyecto obtiene un endpoint MCP, un endpoint REST y una página de destino legible por IA.

Cómo se ve el éxito

Cuatro momentos de un proyecto real, para confirmar que vas por buen camino. Mira el resultado en vivo: el proyecto de demostración Invokera Status.

Tres formas de importar

OpenAPI (URL)

Pega la URL de una especificación OpenAPI/Swagger pública en la pestaña OpenAPI de la consola: la vía más rápida y completa.

curl

Pega un comando curl funcional en la pestaña curl de la consola — Invokera deriva de él una herramienta tipada. Por ejemplo:

curl https://api.example.com/v1/users -H "Authorization: Bearer KEY"

Postman

En Postman, exporta tu colección como Collection v2.1 JSON y pega el JSON en la pestaña Postman de la consola.

Solución de problemas de verificación de dominio

La verificación busca un registro TXT en _invokera-challenge.<tu-dominio> (o un archivo en /.well-known/invokera-challenge.txt). Cada desafío es válido durante 72 horas y admite hasta 30 comprobaciones. Fallos más comunes:

Conectar vía MCP

Claude Code

La forma más rápida de conectar: ejecuta un comando en tu terminal:

claude mcp add --transport http your-project https://invokera.com/r/your-project --header "Authorization: Bearer inv_YOUR_TOKEN"

Comprobación de éxito: haz una pregunta en el chat; si ves los nombres de tus herramientas, la conexión funciona.

Claude Desktop

Añade tu proyecto a claude_desktop_config.json usando el endpoint HTTP streamable y tu token de endpoint:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "your-project": {
      "type": "http",
      "url": "https://invokera.com/r/your-project",
      "headers": { "Authorization": "Bearer inv_YOUR_TOKEN" }
    }
  }
}

Tras editar el archivo de tu sistema operativo, reinicia Claude Desktop para aplicar el cambio.

Comprobación de éxito: haz una pregunta en el chat; si ves los nombres de tus herramientas, la conexión funciona.

Cursor

Crea .cursor/mcp.json en la raíz de tu proyecto con la misma forma JSON:

{
  "mcpServers": {
    "your-project": {
      "type": "http",
      "url": "https://invokera.com/r/your-project",
      "headers": { "Authorization": "Bearer inv_YOUR_TOKEN" }
    }
  }
}

Comprobación de éxito: haz una pregunta en el chat; si ves los nombres de tus herramientas, la conexión funciona.

REST

¿Sin cliente MCP? Cada proyecto expone además un endpoint REST autodescriptivo:

curl https://invokera.com/v1/your-project/tools -H "Authorization: Bearer inv_YOUR_TOKEN"

Automatización / CI

Las claves API de plataforma (ik_) para gestionar proyectos por script aún no están disponibles en autoservicio. Si necesitas automatización o integración CI, contáctanos y habilitaremos una para tu cuenta. Una llamada tendrá esta forma:

curl -X POST https://invokera.com/api/v1/projects -H "Authorization: Bearer ik_YOUR_API_KEY" -H "Content-Type: application/json" -d '{"specUrl":"https://api.example.com/openapi.json"}'

FAQ

Mi llamada falla con un código de error — ¿qué significa?

Los errores MCP llevan un código JSON-RPC y un estado HTTP. Los más frecuentes:

La verificación del dominio sigue fallando — ¿qué debo revisar?

Los registros DNS TXT pueden tardar en propagarse — espera unos minutos y verifica de nuevo. La verificación apunta al dominio registrable (eTLD+1), no al subdominio. Si tu API vive en el subdominio de una plataforma de alojamiento, usa en su lugar el método del archivo .well-known.

¿Cuál es la diferencia entre los tokens inv_ e ik_?

Los tokens de endpoint inv_ solo permiten invocar tus herramientas publicadas. Las claves API de plataforma ik_ gestionan tu cuenta y tus proyectos — nunca se las entregues a agentes.

¿Cómo roto un token de endpoint?

Abre el proyecto en la consola y usa «Rotar token». El token antiguo deja de funcionar de inmediato, así que actualiza tus agentes justo después.

Perdí mi token de invocación — ¿cómo lo recupero?

Los tokens no se vuelven a mostrar. En la página del proyecto usa «Rotar token»: obtienes uno nuevo al instante y el antiguo deja de funcionar — actualiza todos los clientes que lo usaban.

Claude está conectado pero no ve herramientas — ¿qué pasa?

Suele ser una de tres causas: el proyecto no tiene herramientas habilitadas (actívalas en la consola); el cliente no se reinició por completo tras cambiar su configuración (Claude Desktop debe cerrarse y abrirse de nuevo); la URL del endpoint o el token están mal — usa la llamada de prueba de la consola para descartar el lado del servidor.