MCP quickstart

Connect the MCP in 2 minutes

From zero to your first analysis through your assistant. No HTTP: paste the config, confirm with health and call the tools.

1. Create your fai_ key
In the dashboard, create a key. It works for all 5 tools and is the only secret the MCP client stores.
Open the dashboard
2. Paste the config into your client
Pick your client below, copy the block and replace fai_... with your key. The interface changes between versions: what matters is the URL and the Authorization header.

Connect your MCP client

Each client uses a different field for a remote server. Copy your block and replace fai_... with your key.

Claude Code

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

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

Claude Code MCP

VS Code / Copilot

File: .vscode/mcp.json

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

VS Code MCP configuration

Cursor

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

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

Cursor MCP

Gemini CLI

File: ~/.gemini/settings.json

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

Gemini CLI MCP servers

Each client doc is linked under the block. UIs change between versions: what matters is the URL and the Authorization header.

3. Confirm the connection with health (free)
health costs no credits and confirms URL, version and API phase before you call anything that charges.
tool: health
4. Run your first analysis
Ask the assistant: “transcribe this audio and run the diagnosis”. It calls transcribe_audio and diagnostic and returns the risk score, evidence and usage.credits_consumed.
Every call charges credits and the result is not retrievable afterwards: read the full response and save the JSON if you need it.

If something fails

Code	What to do
401	Invalid or missing key: check the Authorization: Bearer fai_... header
402	No credits: buy a one-time pack or change plan
429	Rate limit: wait for the Retry-After value
500	Server error: try again and note the time

Back Talk to Action

Connect the MCP in 2 minutes

1. Create your fai_ key

2. Paste the config into your client