> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.6mm.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.6mm.com/_mcp/server.

# Local MCP

> **Planejado – ainda não lançado**
> AI Hub é um recurso planejado. Recursos, terminais, comandos e configurações do cliente nesta página descrevem o design proposto e não estão disponíveis no momento. A disponibilidade final e as instruções de configuração serão anunciadas no lançamento.

Local MCP é a configuração recomendada quando um cliente de IA precisa de contexto de conta privada ou ferramentas de negociação controladas no futuro.

O servidor MCP é executado na máquina do usuário. O cliente AI chama ferramentas locais 6MM e o servidor local se comunica com 6MM APIs usando credenciais configuradas pelo usuário.

## O que seu cliente de IA pode fazer

Com Local MCP, um cliente de IA pode usar ferramentas 6MM de forma controlada:

* Obtenha dados históricos e ao vivo do mercado.
* Leia saldos de contas, posições, pedidos abertos, preenchimentos e registros de financiamento quando as credenciais somente leitura estiverem habilitadas.
* Explique a exposição do portfólio, uso de margem e risco de liquidação.
* Visualize os pedidos antes que qualquer pedido real seja feito.
* Nas fases posteriores de negociação controlada, crie ou cancele pedidos somente após permissão explícita e verificações de risco.

Use Local MCP quando as credenciais devem permanecer na máquina do usuário.

## Arquitetura

```text
AI client
  -> local 6mm-mcp process
  -> 6MM REST / WebSocket API
```

## Configuração de exemplo

```json
{
  "mcpServers": {
    "6mm": {
      "command": "uvx",
      "args": ["6mm-mcp"],
      "env": {
        "SIXMM_ENVIRONMENT": "testnet",
        "SIXMM_API_KEY": "your_api_key",
        "SIXMM_API_SECRET": "your_api_secret"
      }
    }
  }
}
```

## Níveis de permissão recomendados

| Nível                   | Ferramentas                                                               | Notas                                                         |
| ----------------------- | ------------------------------------------------------------------------- | ------------------------------------------------------------- |
| Dados públicos          | Mercados, ticker, carteira de pedidos, klines, negociações, financiamento | Sem acesso à conta privada.                                   |
| Leitura da conta        | Saldos, posições, ordens abertas, preenchimentos                          | Requer escopo de chave API somente leitura.                   |
| Antevisão da negociação | Pedido de visualização, impacto na margem, estimativa de taxas            | Não faz pedidos.                                              |
| Negociação controlada   | Criar, cancelar, alterar pedidos                                          | Requer permissão explícita, confirmação e controles de risco. |

## Lista de verificação da primeira configuração

1. Instale o pacote MCP.
2. Crie ou configure uma chave API somente leitura.
3. Comece na rede de teste.
4. Adicione o servidor MCP à configuração do cliente AI.
5. Peça ao cliente para listar as ferramentas 6MM disponíveis.
6. Execute uma consulta de dados de mercado público.
7. Só então adicione credenciais de leitura da conta, se necessário.

## Solicitações de exemplo

```text
Use 6MM to list available perpetual markets.
```

```text
Use 6MM testnet to check my open positions and explain liquidation risk.
```

```text
Preview a small BTC long order on 6MM testnet and explain margin impact. Do not place the order.
```

## Notas de segurança

O local MCP deve ser padronizado como somente leitura e testnet. As ferramentas de negociação devem exigir visualização, confirmação do usuário, chaves de idempotência, limites nocionais e verificações de risco do lado do serviço.