Claude Code
Arquivo: .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
Do zero à primeira análise pelo seu assistente. Sem escrever HTTP: você cola a config, confirma com health e chama as tools.
No dashboard, crie uma chave. Ela vale para as 5 tools e é o único segredo que o cliente MCP guarda.
Abrir o dashboardEscolha o cliente abaixo, copie o bloco e troque fai_... pela sua chave. A interface muda entre versões: o que importa é a URL e o header Authorization.
Cada cliente usa um campo diferente para o servidor remoto. Copie o bloco do seu e troque o fai_... pela sua chave.
Arquivo: .mcp.json (raiz do projeto) ou ~/.claude.json
{
"mcpServers": {
"falaai": {
"type": "http",
"url": "https://mcp-falaai.action.tec.br/mcp",
"headers": { "Authorization": "Bearer fai_..." }
}
}
}Arquivo: .vscode/mcp.json
{
"servers": {
"falaai": {
"type": "http",
"url": "https://mcp-falaai.action.tec.br/mcp",
"headers": { "Authorization": "Bearer fai_..." }
}
}
}Arquivo: .cursor/mcp.json ou ~/.cursor/mcp.json
{
"mcpServers": {
"falaai": {
"url": "https://mcp-falaai.action.tec.br/mcp",
"headers": { "Authorization": "Bearer fai_..." }
}
}
}Arquivo: ~/.gemini/settings.json
{
"mcpServers": {
"falaai": {
"httpUrl": "https://mcp-falaai.action.tec.br/mcp",
"headers": { "Authorization": "Bearer fai_..." }
}
}
}A documentação de cada cliente está linkada abaixo do bloco. A interface muda entre versões: o que importa é a URL e o header Authorization.
health não gasta créditos e confirma URL, versão e fase da API antes de você chamar qualquer coisa que cobre.
tool: healthPeça ao assistente: “transcreva este áudio e faça o diagnóstico”. Ele chama transcribe_audio e diagnostic e devolve nota de risco, evidências e usage.credits_consumed.
Cada chamada cobra créditos e o resultado não é recuperável depois: leia o retorno completo e salve o JSON se precisar.
| Código | O que fazer |
|---|---|
| 401 | Chave inválida ou ausente: confira o header Authorization: Bearer fai_... |
| 402 | Sem créditos: compre pacote avulso ou troque de plano |
| 429 | Limite de requisições: espere o Retry-After informado |
| 500 | Erro do servidor: tente novamente e registre o horário |