Opiny MCP Server (HTTP Streamable)

Servidor oficial do Model Context Protocol (MCP) para a API da Opiny.

Este projeto utiliza uma arquitetura híbrida:

1. STDIO: Para uso local (Claude Desktop).

2. HTTP Stream: Para uso remoto, expondo o protocolo MCP diretamente sobre uma conexão HTTP persistente (NDJSON).

🚀 1. Hospedagem no Dokploy (Produção)

Este modo expõe um endpoint único (/mcp) que aceita conexões persistentes.

Deploy

1. Docker Image: Use o Dockerfile incluso.

2. Porta: Exponha a porta 7012.

3. Domínio: Configure HTTPS (ex: ai.opiny.com.br).

4. Variáveis: Nenhuma chave de API é necessária no servidor.

Conectando Clientes (Remoto)

Como este servidor usa "HTTP Stream" em vez de SSE padrão, a configuração do cliente depende do suporte a este transporte.

URL do Endpoint: https://ai.opiny.com.br/mcp Headers Obrigatórios: x-api-key: SUA_CHAVE_OPINY_AQUI

{
  "mcpServers": {
    "opiny": {
      "url": "[https://ai.opiny.com.br/mcp](https://ai.opiny.com.br/mcp)",
      "headers": {
        "x-api-key": "SUA_CHAVE_OPINY_AQUI"
      }
    }
  }
}

Related MCP server: @cyanheads/onebusaway-mcp-server

💻 2. Uso com Claude Desktop (Local)

Para o Claude Desktop, continuamos recomendando o uso via Docker local (modo STDIO), pois garante compatibilidade máxima.

Imagem do container:

Rode esse comando para realizar o build do container de forma local:

docker build -t ghcr.io/opinysaas/mcp-opiny:latest .

Após essa etapa, inicie o container.

Arquivo de Configuração:

{
  "mcpServers": {
    "opiny": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "OPINY_API_KEY=SUA_CHAVE_OPINY_AQUI",
        "ghcr.io/opinysaas/mcp-opiny:latest",
        "node",
        "index.js",
        "--stdio"
      ]
    }
  }
}