Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.indiqai.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Conectando clientes MCP ao IndiqAI

O IndiqAI expõe um servidor MCP remoto nativo em https://api.indiqai.com/mcp. Para Claude Code, GitHub Copilot e Codex, o caminho recomendado agora é conectar esse endpoint remoto por URL com type: "http".

​
Pré-requisitos

Se você prefere integração HTTP direta, pode pular esta página e chamar a API pública em https://api.indiqai.com/api/v1/public.
Antes de configurar qualquer cliente, tenha em mãos:
  1. Uma API Key do IndiqAI com acesso à API pública
  2. O endpoint MCP oficial:
https://api.indiqai.com/mcp
  1. Um ambiente seguro para armazenar a chave

​
Variáveis recomendadas

INDIQAI_MCP_BASE_URL=https://api.indiqai.com/mcp
INDIQAI_API_KEY=indiqai_sua_chave_aqui
O IndiqAI agora expõe um servidor MCP remoto nativo. Você não precisa mais manter um adaptador local só para traduzir HTTP em tools MCP.

​
O que o cliente MCP precisa suportar

Seu cliente MCP deve:
  1. cadastrar um servidor remoto por URL
  2. usar type: "http"
  3. enviar X-API-Key ou Authorization: Bearer ...
  4. respeitar 429, Retry-After e idempotência dos writes críticos

​
Claude Code

O Claude Code funciona bem com configuração por projeto via .mcp.json.

​
1. Pré-requisitos

  • API Key do IndiqAI disponível no ambiente local

​
2. Adicione o servidor MCP do IndiqAI

No diretório do projeto, configure um .mcp.json apontando direto para o endpoint remoto. 
{
  "mcpServers": {
    "indiqai": {
      "type": "http",
      "url": "https://api.indiqai.com/mcp",
      "headers": {
        "X-API-Key": "indiqai_sua_chave_aqui"
      }
    }
  }
}

​
3. Recarregue o Claude Code

Depois de salvar a configuração:
  • reinicie a descoberta de MCP do Claude Code
  • verifique se as tools aparecem com o nome do servidor indiqai

​
4. Teste a conexão

Faça um teste simples, como listar clientes ou produtos.

​
Detalhes de configuração

Em geral, o Claude Code pode trabalhar com configuração no nível do usuário ou do projeto. Para integração do IndiqAI, recomendamos começar pelo nível de projeto e manter a chave fora de versionamento.

​
Referências

​
GitHub Copilot

No VS Code com GitHub Copilot, configure o servidor MCP em .vscode/mcp.json.

​
1. Pré-requisitos

  • VS Code com suporte a MCP
  • GitHub Copilot habilitado
  • API Key do IndiqAI disponível localmente

​
2. Adicione o servidor MCP do IndiqAI

{
  "inputs": [
    {
      "type": "promptString",
      "id": "indiqaiApiKey",
      "description": "IndiqAI API Key",
      "password": true
    }
  ],
  "servers": {
    "indiqai": {
      "type": "http",
      "url": "https://api.indiqai.com/mcp",
      "headers": {
        "X-API-Key": "${input:indiqaiApiKey}"
      }
    }
  }
}

​
3. Inicie o servidor MCP

No fluxo de uso:
  1. salve o arquivo .vscode/mcp.json
  2. inicie o servidor MCP no próprio editor
  3. abra o Copilot Chat em modo Agent
  4. confira se o servidor indiqai está disponível

​
4. Teste a conexão

Peça algo simples como listar clientes ou produtos.

​
Referências

​
Codex

O Codex usa config.toml para registrar servidores MCP.

​
1. Pré-requisitos

  • Codex instalado
  • API Key do IndiqAI disponível no ambiente local

​
2. Configure o servidor MCP do IndiqAI

No Codex, a configuração pode ficar em ~/.codex/config.toml ou .codex/config.toml do projeto. 
[mcp_servers.indiqai]
type = "http"
url = "https://api.indiqai.com/mcp"

[mcp_servers.indiqai.headers]
X-API-Key = "indiqai_sua_chave_aqui"

​
3. Valide a conexão

Depois disso:
  • abra /mcp no Codex para validar que o servidor está ativo
  • teste uma tool simples antes de liberar writes com idempotência

​
Referências

​
Prompt de teste sugerido

Depois de conectar o servidor, valide com uma instrução simples como: 
Liste os clientes disponíveis no MCP do IndiqAI e resuma os primeiros resultados.

​
Boas práticas

  • mantenha a API Key apenas no lado servidor ou no segredo local do seu cliente MCP
  • use uma chave separada por integração
  • rotacione chaves comprometidas imediatamente
  • respeite 429 e Retry-After
  • preserve X-Idempotency-Key nos 3 writes críticos
  • nunca tente usar o MCP público a partir de frontend ou app cliente

​
Ferramentas para começar

Os melhores primeiros testes costumam ser:
  • list_clients
  • list_products
  • get_metrics_overview
Quando esses três funcionam, a autenticação, a URL do servidor remoto e o catálogo principal do MCP normalmente já estão corretos.

​
Recursos adicionais