GoPluto AI MCP Server

oficial

MCP para especialistas humanos rápidos

GitHub
2

Documentação

Cover

GoPluto MCP — Conhecimento de Serviço Atualizado e Snippets em Qualquer Prompt

Website MCPMCP Badge MIT licensed

Install in Cursor (Remote) Install in Cursor (Local proxy)

O GoPluto MCP permite que assistentes de codificação com IA obtenham conhecimento atualizado de serviços/provedores, regras de roteamento e snippets prontos para colar do GoPluto — diretamente no seu prompt.

❌ Sem o GoPluto

  • ❌ Nenhuma garantia de encontrar o especialista certo quando você realmente precisa
  • ❌ Provedores inventados e fluxos quebrados desperdiçam tempo
  • ❌ Troca constante de contexto entre pessoas atrasa você

✅ Com o GoPluto

Adicione use gopluto no seu prompt (ou defina uma regra uma vez) e o assistente busca contexto ao vivo do GoPluto:

  • Conhecimento de provedor atualizado e verificado, puxado diretamente para o seu prompt
  • dicas e filtros instantâneos de correspondência de provedores
  • payloads mínimos e trechos de código para acesso a especialistas em minutos

Exemplos

Draft a WhatsApp onboarding flow that asks for experts within minutes. use gopluto

Show me the minimal payload to create a Service Request and start matching experts in under 60 seconds. use gopluto

🛠️ Instalação

Requisitos

  • Qualquer cliente compatível com MCP (Cursor, Claude Code, VS Code, Windsurf, Zed, etc.)
  • Chave de API do GoPluto (mantenha no lado do cliente)
  • Acesso de rede a https://api.gopluto.ai/mcp

Cabeçalho de autenticação: gopluto-api-key: YOUR_API_KEY

Se o seu cliente não puder anexar cabeçalhos a servidores remotos, use o proxy stdio local incluído (main.py) para adicionar o cabeçalho para você.

Cursor

Um clique (HTTP Remoto)

Install in Cursor (Remote)

Manual (Remoto)

{
  "mcpServers": {
    "gopluto": {
      "url": "https://api.gopluto.ai/mcp",
      "headers": { "gopluto-api-key": "YOUR_API_KEY" }
    }
  }
}

Local (proxy stdio)

{
  "mcpServers": {
    "gopluto": {
      "command": "uv",
      "args": ["run","python3","/ABSOLUTE/PATH/TO/gopluto-mcp/main.py"],
      "env": {
        "GOPLUTO_MCP_URL": "https://api.gopluto.ai/mcp",
        "GOPLUTO_AUTH_HEADER": "gopluto-api-key",
        "GOPLUTO_API_KEY": "YOUR_API_KEY",
        "GOPLUTO_TRANSPORT": "sse"
      }
    }
  }
}

Claude Code (CLI)

Remoto

claude mcp add --transport http gopluto https://api.gopluto.ai/mcp \
  --header "gopluto-api-key: YOUR_API_KEY"

Local

claude mcp add gopluto -- uv run python3 /ABSOLUTE/PATH/TO/gopluto-mcp/main.py

Windsurf

Remoto

{
  "mcpServers": {
    "gopluto": {
      "serverUrl": "https://api.gopluto.ai/mcp",
      "headers": { "gopluto-api-key": "YOUR_API_KEY" }
    }
  }
}

Local

{
  "mcpServers": {
    "gopluto": {
      "command": "uv",
      "args": ["run","python3","/ABSOLUTE/PATH/TO/gopluto-mcp/main.py"]
    }
  }
}

VS Code (Copilot Chat MCP)

Remoto

"mcp": {
  "servers": {
    "gopluto": {
      "type": "http",
      "url": "https://api.gopluto.ai/mcp",
      "headers": { "gopluto-api-key": "YOUR_API_KEY" }
    }
  }
}

Local

"mcp": {
  "servers": {
    "gopluto": {
      "type": "stdio",
      "command": "uv",
      "args": ["run","python3","/ABSOLUTE/PATH/TO/gopluto-mcp/main.py"]
    }
  }
}

Cline

Marketplace → pesquise GoPluto → Instalar

Manual (Remoto)

{
  "mcpServers": {
    "gopluto": {
      "url": "https://api.gopluto.ai/mcp",
      "type": "streamableHttp",
      "headers": { "gopluto-api-key": "YOUR_API_KEY" }
    }
  }
}

Zed

{
  "context_servers": {
    "GoPluto": {
      "command": {
        "path": "uv",
        "args": ["run","python3","/ABSOLUTE/PATH/TO/gopluto-mcp/main.py"]
      }
    }
  }
}

Augment Code

IU → Configurações → Ferramentas → + Adicionar MCP → Comando:

uv run python3 /ABSOLUTE/PATH/TO/gopluto-mcp/main.py

Manual

"augment.advanced": {
  "mcpServers": [
    {
      "name": "gopluto",
      "command": "uv",
      "args": ["run","python3","/ABSOLUTE/PATH/TO/gopluto-mcp/main.py"]
    }
  ]
}

Roo Code

Remoto

{
  "mcpServers": {
    "gopluto": {
      "type": "streamable-http",
      "url": "https://api.gopluto.ai/mcp",
      "headers": { "gopluto-api-key": "YOUR_API_KEY" }
    }
  }
}

Local

{
  "mcpServers": {
    "gopluto": {
      "command": "uv",
      "args": ["run","python3","/ABSOLUTE/PATH/TO/gopluto-mcp/main.py"]
    }
  }
}

Gemini CLI

Remoto

{
  "mcpServers": {
    "gopluto": {
      "httpUrl": "https://api.gopluto.ai/mcp",
      "headers": {
        "gopluto-api-key": "YOUR_API_KEY",
        "Accept": "application/json, text/event-stream"
      }
    }
  }
}

Local

{
  "mcpServers": {
    "gopluto": {
      "command": "uv",
      "args": ["run","python3","/ABSOLUTE/PATH/TO/gopluto-mcp/main.py"]
    }
  }
}

Claude Desktop

Remoto: Configurações → Conectores → Adicionar Conector Personalizado
URL: https://api.gopluto.ai/mcp
Cabeçalho: gopluto-api-key: YOUR_API_KEY

Local: Configurações do desenvolvedor → editar claude_desktop_config.json

{
  "mcpServers": {
    "gopluto": {
      "command": "uv",
      "args": ["run","python3","/ABSOLUTE/PATH/TO/gopluto-mcp/main.py"],
      "env": {
        "GOPLUTO_MCP_URL": "https://api.gopluto.ai/mcp",
        "GOPLUTO_AUTH_HEADER": "gopluto-api-key",
        "GOPLUTO_API_KEY": "YOUR_API_KEY",
        "GOPLUTO_TRANSPORT": "sse"
      }
    }
  }
}

Opencode

Remoto

"mcp": {
  "gopluto": {
    "type": "remote",
    "url": "https://api.gopluto.ai/mcp",
    "headers": { "gopluto-api-key": "YOUR_API_KEY" },
    "enabled": true
  }
}

Local

"mcp": {
  "gopluto": {
    "type": "local",
    "command": ["uv","run","python3","/ABSOLUTE/PATH/TO/gopluto-mcp/main.py"],
    "enabled": true
  }
}

JetBrains AI Assistant

Configurações → Ferramentas → AI Assistant → Model Context Protocol (MCP) → + Adicionar → Como JSON

{
  "mcpServers": {
    "gopluto": {
      "command": "uv",
      "args": ["run","python3","/ABSOLUTE/PATH/TO/gopluto-mcp/main.py"]
    }
  }
}

Kiro

{
  "mcpServers": {
    "GoPluto": {
      "command": "uv",
      "args": ["run","python3","/ABSOLUTE/PATH/TO/gopluto-mcp/main.py"],
      "env": {},
      "disabled": false,
      "autoApprove": []
    }
  }
}

Trae

Remoto

{
  "mcpServers": {
    "gopluto": { "url": "https://api.gopluto.ai/mcp" }
  }
}

Local

{
  "mcpServers": {
    "gopluto": {
      "command": "uv",
      "args": ["run","python3","/ABSOLUTE/PATH/TO/gopluto-mcp/main.py"]
    }
  }
}

Bun / Deno (local)

Bun

{
  "mcpServers": {
    "gopluto": {
      "command": "bunx",
      "args": ["uv","run","python3","/ABSOLUTE/PATH/TO/gopluto-mcp/main.py"]
    }
  }
}

Deno

{
  "mcpServers": {
    "gopluto": {
      "command": "deno",
      "args": ["run","--allow-run","--allow-env","--allow-net","/ABSOLUTE/PATH/TO/gopluto-mcp/deno_shim.ts"]
    }
  }
}

Docker (HTTP local)

Dockerfile

FROM python:3.11-slim
WORKDIR /app
COPY requirements.txt main.py ./
RUN pip install --no-cache-dir -r requirements.txt
ENV GOPLUTO_MCP_URL=https://api.gopluto.ai/mcp \
    GOPLUTO_AUTH_HEADER=gopluto-api-key \
    GOPLUTO_TRANSPORT=sse
EXPOSE 12006
CMD ["python","main.py","--mode","http","--host","0.0.0.0","--port","12006"]

Execute:

docker build -t gopluto-mcp .
docker run --rm -p 12006:12006 -e GOPLUTO_API_KEY=YOUR_API_KEY gopluto-mcp

Aponte seu cliente para http://localhost:12006.

Notas para Windows

Se caminhos/aspas forem complicados, use cmd /c ou PowerShell; prefira caminhos absolutos para command e args.

🔧 Ferramentas Disponíveis (exemplos)

  • resolve-gopluto-id – Resolver um nome de pacote/serviço para um ID do GoPluto
  • get-gopluto-docs – Buscar docs/snippets para um ID do GoPluto
  • search-providers – Consultar provedores por habilidades/geografia/orçamento
  • create-service-request – Auxiliar de payload mínimo

(A lista de ferramentas do seu servidor upstream pode evoluir; use o inspetor de ferramentas do seu cliente para listá-las.)

🛟 Dicas

Adicione uma Regra para usar o GoPluto automaticamente

Always use gopluto when I ask for service matching, onboarding flows, or API payloads.
Automatically call GoPluto MCP tools to resolve IDs and fetch snippets.

Proxy HTTPS: variáveis de ambiente padrão HTTPS_PROXY / https_proxy se aplicam.

💻 Desenvolvimento (proxy local)

uv pip install -r requirements.txt
export GOPLUTO_API_KEY="YOUR_REAL_KEY"
uv run python3 main.py               # stdio (default)
# or:
uv run python3 main.py --mode http --port 12006

Teste de fumaça do servidor remoto

curl -X POST "https://api.gopluto.ai/mcp" \
  -H "Content-Type: application/json" \
  -H "gopluto-api-key: $GOPLUTO_API_KEY" \
  -d '{"jsonrpc":"2.0","id":"1","method":"initialize","params":{"protocolVersion":"2025-06-18"}}'

🚨 Solução de Problemas

  • 401/403 → gopluto-api-key errada/ausente
  • Cliente não pode adicionar cabeçalhos → use o proxy stdio local
  • Problemas de TLS → defina SSL_CERT_FILE para Python
  • Módulo não encontrado (Node) → prefira o proxy Python (não precisa de Node)

📄 Licença

MIT