superdocs-mcp

Cliente MCP do SuperDocs para Cursor, Claude Desktop, VS Code e outras IDEs com suporte a MCP via stdio.

Você configura URL do servidor e token uma vez. Depois a IDE só precisa chamar o binário — sem colar Bearer em todo mcp.json.

Este pacote não inclui endereço de servidor nem tokens. Cada usuário informa os próprios.

Instalação rápida

npx -y superdocs-mcp config

Informe a URL base do MCP (ex.: https://seu-host:8091 ou https://seu-host:8091/mcp) e o token de acesso.

Credenciais ficam em ~/.superdocs/config.json (Windows: %USERPROFILE%\.superdocs\config.json).

IDE (uma vez)

Cursor — .cursor/mcp.json ou settings MCP

{
  "mcpServers": {
    "superdocs": {
      "command": "npx",
      "args": ["-y", "superdocs-mcp"]
    }
  }
}

Claude Desktop

No claude_desktop_config.json:

{
  "mcpServers": {
    "superdocs": {
      "command": "npx",
      "args": ["-y", "superdocs-mcp"]
    }
  }
}

Não é necessário colocar token no JSON da IDE se você já rodou superdocs-mcp config.

Variáveis de ambiente (opcional)

Têm prioridade sobre o arquivo de config:

| Variável | Descrição | |----------|-----------| | SUPERDOCS_URL | URL do endpoint MCP (com ou sem /mcp) | | SUPERDOCS_TOKEN | Token Bearer de acesso | | SUPERDOCS_HOST | Só host/IP (alternativa à URL) | | SUPERDOCS_PORT | Porta (default 8091 se usar SUPERDOCS_HOST) |

Comandos

npx superdocs-mcp              # sobe o proxy stdio (uso da IDE)
npx superdocs-mcp config       # grava URL + token
npx superdocs-mcp config --show  # mostra config (token mascarado)
npx superdocs-mcp setup        # imprime o JSON pronto para colar na IDE

Privacidade

• Nada de credenciais é publicado neste pacote.
• O arquivo local ~/.superdocs/config.json não deve ser commitado.