# Opiny MCP Server (HTTP Streamable)

Servidor oficial do [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) 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`

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

---

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

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

Após essa etapa, inicie o container.

**Arquivo de Configuração:**

```json
{
  "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"
      ]
    }
  }
}
```