> ## 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

> Setup passo a passo para Claude Code, GitHub Copilot e Codex usando o MCP público do IndiqAI

# 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

<Tip>
  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`.
</Tip>

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**:

```text theme={null}
https://api.indiqai.com/mcp
```

3. **Um ambiente seguro** para armazenar a chave

## Variáveis recomendadas

```bash theme={null}
INDIQAI_MCP_BASE_URL=https://api.indiqai.com/mcp
INDIQAI_API_KEY=indiqai_sua_chave_aqui
```

<Warning>
  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.
</Warning>

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

```json theme={null}
{
  "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](https://code.claude.com/docs/en/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

```json theme={null}
{
  "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

* [GitHub Copilot + MCP no VS Code](https://docs.github.com/en/copilot/customizing-copilot/extending-copilot-chat-with-mcp)

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

```toml theme={null}
[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](https://developers.openai.com/codex/mcp)

## Prompt de teste sugerido

Depois de conectar o servidor, valide com uma instrução simples como:

```text theme={null}
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

* [Usando o MCP do IndiqAI](/api-reference/public-api/mcp-indiqai)
* [Catálogo de tools](/api-reference/public-api/tools-catalog)
* [Autenticação](/api-reference/public-api/authentication)
* [Rate Limits](/api-reference/public-api/rate-limits)
* [Erros](/api-reference/public-api/errors)