← Voltar

Quickstart MCP

Conecte o MCP em 2 minutos

Do zero à primeira análise pelo seu assistente. Sem escrever HTTP: você cola a config, confirma com health e chama as tools.

  1. 1. Gere sua chave fai_

    No dashboard, crie uma chave. Ela vale para as 5 tools e é o único segredo que o cliente MCP guarda.

    Abrir o dashboard
  2. 2. Cole a config no seu cliente

    Escolha 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.

Conecte o seu cliente MCP

Cada cliente usa um campo diferente para o servidor remoto. Copie o bloco do seu e troque o fai_... pela sua chave.

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_..." }
    }
  }
}

VS Code / Copilot

Arquivo: .vscode/mcp.json

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

Cursor

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

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

Gemini CLI

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.

  1. 3. Confirme a conexão com health (grátis)

    health não gasta créditos e confirma URL, versão e fase da API antes de você chamar qualquer coisa que cobre.

    tool: health
  2. 4. Rode a primeira análise

    Peç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.

Se algo falhar

CódigoO que fazer
401Chave inválida ou ausente: confira o header Authorization: Bearer fai_...
402Sem créditos: compre pacote avulso ou troque de plano
429Limite de requisições: espere o Retry-After informado
500Erro do servidor: tente novamente e registre o horário
Quickstart MCP: conecte em 2 minutos | FalaAI