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_..." }
}
}
}Quickstart MCP
De cero al primer análisis con tu asistente. Sin escribir HTTP: pegas la config, confirmas con health y llamas a las tools.
En el dashboard, crea una clave. Sirve para las 5 tools y es el único secreto que guarda el cliente MCP.
Abrir el dashboardElige 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.
Cada cliente usa un campo distinto para el servidor remoto. Copia tu bloque y cambia fai_... por tu clave.
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_..." }
}
}
}Archivo: .vscode/mcp.json
{
"servers": {
"falaai": {
"type": "http",
"url": "https://mcp-falaai.action.tec.br/mcp",
"headers": { "Authorization": "Bearer fai_..." }
}
}
}Archivo: .cursor/mcp.json ou ~/.cursor/mcp.json
{
"mcpServers": {
"falaai": {
"url": "https://mcp-falaai.action.tec.br/mcp",
"headers": { "Authorization": "Bearer fai_..." }
}
}
}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.
health no gasta créditos y confirma URL, versión y fase de la API antes de llamar algo que cobre.
tool: healthPí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.
| Código | Qué hacer |
|---|---|
| 401 | Clave inválida o ausente: revisa el header Authorization: Bearer fai_... |
| 402 | Sin créditos: compra un pack puntual o cambia de plan |
| 429 | Límite de peticiones: espera el Retry-After indicado |
| 500 | Error del servidor: reintenta y registra la hora |