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:

Uma API Key do IndiqAI com acesso à API pública
O endpoint MCP oficial:

https://api.indiqai.com/mcp

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:

cadastrar um servidor remoto por URL
usar type: "http"
enviar X-API-Key ou Authorization: Bearer ...
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

Claude Code MCP

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:

salve o arquivo .vscode/mcp.json
inicie o servidor MCP no próprio editor
abra o Copilot Chat em modo Agent
confira se o servidor indiqai está disponível

4. Teste a conexão

Peça algo simples como listar clientes ou produtos.

Referências

GitHub Copilot + MCP no VS Code

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

MCP no Codex

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.

Comece aqui

Clientes

Cupons

Produtos

Cartões Fidelidade

Indicações

Quests Públicas

NFC-e

Email

Pontos

Métricas

Prêmios

Conectando clientes MCP ao IndiqAI

Conectando clientes MCP ao IndiqAI

Pré-requisitos

Variáveis recomendadas

O que o cliente MCP precisa suportar

Claude Code

1. Pré-requisitos

2. Adicione o servidor MCP do IndiqAI

3. Recarregue o Claude Code

4. Teste a conexão

Detalhes de configuração

Referências

GitHub Copilot

1. Pré-requisitos

2. Adicione o servidor MCP do IndiqAI

3. Inicie o servidor MCP

4. Teste a conexão

Referências

Codex

1. Pré-requisitos

2. Configure o servidor MCP do IndiqAI

3. Valide a conexão

Referências

Prompt de teste sugerido

Boas práticas

Ferramentas para começar

Recursos adicionais

​Conectando clientes MCP ao IndiqAI

​Pré-requisitos

​Variáveis recomendadas

​O que o cliente MCP precisa suportar

​Claude Code

​1. Pré-requisitos

​2. Adicione o servidor MCP do IndiqAI

​3. Recarregue o Claude Code

​4. Teste a conexão

​Detalhes de configuração

​Referências

​GitHub Copilot

​1. Pré-requisitos

​2. Adicione o servidor MCP do IndiqAI

​3. Inicie o servidor MCP

​4. Teste a conexão

​Referências

​Codex

​1. Pré-requisitos

​2. Configure o servidor MCP do IndiqAI

​3. Valide a conexão

​Referências

​Prompt de teste sugerido

​Boas práticas

​Ferramentas para começar

​Recursos adicionais

Conectando clientes MCP ao IndiqAI

Pré-requisitos

Variáveis recomendadas

O que o cliente MCP precisa suportar

Claude Code

1. Pré-requisitos

2. Adicione o servidor MCP do IndiqAI

3. Recarregue o Claude Code

4. Teste a conexão

Detalhes de configuração

Referências

GitHub Copilot

1. Pré-requisitos

2. Adicione o servidor MCP do IndiqAI

3. Inicie o servidor MCP

4. Teste a conexão

Referências

Codex

1. Pré-requisitos

2. Configure o servidor MCP do IndiqAI

3. Valide a conexão

Referências

Prompt de teste sugerido

Boas práticas

Ferramentas para começar

Recursos adicionais