← Volver

Quickstart MCP

Conecta el MCP en 2 minutos

De cero al primer análisis con tu asistente. Sin escribir HTTP: pegas la config, confirmas con health y llamas a las tools.

  1. 1. Genera tu clave fai_

    En el dashboard, crea una clave. Sirve para las 5 tools y es el único secreto que guarda el cliente MCP.

    Abrir el dashboard
  2. 2. Pega la config en tu cliente

    Elige el cliente abajo, copia el bloque y cambia fai_... por tu clave. La interfaz cambia entre versiones: lo que importa es la URL y el header Authorization.

Conecta tu cliente MCP

Cada cliente usa un campo distinto para el servidor remoto. Copia tu bloque y cambia fai_... por tu clave.

Claude Code

Archivo: .mcp.json (raiz do projeto) ou ~/.claude.json

{
  "mcpServers": {
    "falaai": {
      "type": "http",
      "url": "https://mcp-falaai.action.tec.br/mcp",
      "headers": { "Authorization": "Bearer fai_..." }
    }
  }
}

VS Code / Copilot

Archivo: .vscode/mcp.json

{
  "servers": {
    "falaai": {
      "type": "http",
      "url": "https://mcp-falaai.action.tec.br/mcp",
      "headers": { "Authorization": "Bearer fai_..." }
    }
  }
}

Cursor

Archivo: .cursor/mcp.json ou ~/.cursor/mcp.json

{
  "mcpServers": {
    "falaai": {
      "url": "https://mcp-falaai.action.tec.br/mcp",
      "headers": { "Authorization": "Bearer fai_..." }
    }
  }
}

Gemini CLI

Archivo: ~/.gemini/settings.json

{
  "mcpServers": {
    "falaai": {
      "httpUrl": "https://mcp-falaai.action.tec.br/mcp",
      "headers": { "Authorization": "Bearer fai_..." }
    }
  }
}

La documentación de cada cliente está enlazada bajo el bloque. La interfaz cambia entre versiones: lo importante es la URL y el header Authorization.

  1. 3. Confirma la conexión con health (gratis)

    health no gasta créditos y confirma URL, versión y fase de la API antes de llamar algo que cobre.

    tool: health
  2. 4. Ejecuta el primer análisis

    Pídele al asistente: “transcribe este audio y haz el diagnóstico”. Llama a transcribe_audio y diagnostic y devuelve nota de riesgo, evidencias y usage.credits_consumed.

    Cada llamada cobra créditos y el resultado no se recupera después: lee la respuesta completa y guarda el JSON si lo necesitas.

Si algo falla

CódigoQué hacer
401Clave inválida o ausente: revisa el header Authorization: Bearer fai_...
402Sin créditos: compra un pack puntual o cambia de plan
429Límite de peticiones: espera el Retry-After indicado
500Error del servidor: reintenta y registra la hora
Quickstart MCP: conecta en 2 minutos | FalaAI