Vynix MCP

Servidor Model Context Protocol para Vynix. Ele dá aos agentes de codificação acesso direto a feedback visual, relatórios de bugs, capturas de tela, diagnósticos, comentários e fluxos de trabalho de issues, para que os agentes possam raciocinar com base no contexto real em vez de adivinhar.

GitHubExperimente este MCPPatrocinado

Documentação

Servidor Vynix MCP

Por que Vynix

Feedback com evidências: metadados da página, elemento alvo, captura de tela, contexto de console/rede.
Execução de ponta a ponta: inspecionar feedback, diagnosticar, gerar prompts de codificação, criar issues no GitHub, atualizar status, comentar.
Dicas seguras para agentes: anotações somente leitura/idempotentes/mundo aberto para melhor comportamento de aprovação em clientes MCP.
Metadados prontos para registro em diretórios MCP modernos.

Capturas de tela

Placeholder de captura de tela do produto: docs/assets/screenshot-dashboard.png
Placeholder de GIF do fluxo de anotação: docs/assets/workflow-fix-annotation.gif

Arquitetura

flowchart LR
  A[MCP Client\nClaude/Cursor/Copilot/VS Code] -->|stdio or streamable-http| B[Vynix MCP Server]
  B --> C[Vynix API]
  B --> D[GitHub API via Vynix backend]
  C --> E[Projects]
  C --> F[Annotations]
  C --> G[Screenshots and diagnostics]

Recursos

17 ferramentas de produção para fluxos de trabalho de leitura e escrita.
Catálogo de recursos para metadados do servidor, referências de ferramentas/prompts/habilidades e resumos contextuais.
Prompts de fluxo de trabalho para QA, prontidão de lançamento, briefings de gerência de produto e planejamento de engenharia.
Suporte a transporte duplo: stdio e Streamable HTTP.
Autenticação via token de API ou fluxo de atualização por e-mail/senha.

Instalação

Node.js 18+ é necessário.

NPX (recomendado)

{
  "mcpServers": {
    "vynix": {
      "command": "npx",
      "args": ["-y", "@usevynix/mcp-server"],
      "env": {
        "VYNIX_API_URL": "https://www.vynix.in",
        "VYNIX_API_TOKEN": "PASTE_YOUR_TOKEN_HERE"
      }
    }
  }
}

Instalação global via npm

npm install -g @usevynix/mcp-server
vynix-mcp

Docker

docker run --rm -i \
  -e VYNIX_API_URL=https://www.vynix.in \
  -e VYNIX_API_TOKEN=PASTE_YOUR_TOKEN_HERE \
  ghcr.io/usevynix/vynix-mcp:latest

Desenvolvimento local

git clone https://github.com/UseVynix/vynix-mcp.git
cd vynix-mcp
npm install
npm run build
npm run check
node dist/index.js

Configuração do Cliente

Claude Desktop

Use claude_desktop_config.json:

{
  "mcpServers": {
    "vynix": {
      "command": "npx",
      "args": ["-y", "@usevynix/mcp-server"],
      "env": {
        "VYNIX_API_TOKEN": "PASTE_YOUR_TOKEN_HERE"
      }
    }
  }
}

Diagnósticos são gravados em stderr; stdout é reservado para o fluxo do protocolo.

Cursor

Use ~/.cursor/mcp.json.

{
  "mcpServers": {
    "vynix": {
      "command": "npx",
      "args": ["-y", "@usevynix/mcp-server"],
      "env": {
        "VYNIX_API_TOKEN": "PASTE_YOUR_TOKEN_HERE"
      }
    }
  }
}

VS Code

Use .vscode/mcp.json com servers de nível superior:

{
  "servers": {
    "vynix": {
      "command": "npx",
      "args": ["-y", "@usevynix/mcp-server"],
      "env": {
        "VYNIX_API_TOKEN": "PASTE_YOUR_TOKEN_HERE"
      }
    }
  }
}

Windsurf

Use seu arquivo de configuração MCP do Windsurf com este bloco de servidor:

{
  "mcpServers": {
    "vynix": {
      "command": "npx",
      "args": ["-y", "@usevynix/mcp-server"],
      "env": {
        "VYNIX_API_TOKEN": "PASTE_YOUR_TOKEN_HERE"
      }
    }
  }
}

Conectores ChatGPT

Para modo hospedado, use o endpoint Streamable HTTP:

URL base: https://mcp.vynix.in/mcp
Descoberta OAuth: /.well-known/oauth-authorization-server

mcp.json genérico

Veja examples/configs/mcp.json.

Autenticação

Variáveis de ambiente:

VYNIX_API_URL (opcional, padrão: https://www.vynix.in)
VYNIX_API_TOKEN (recomendado)
VYNIX_API_EMAIL e VYNIX_API_PASSWORD (modo de login alternativo)
VYNIX_MCP_MODE (stdio ou http)
VYNIX_MCP_HOST, VYNIX_MCP_PORT, VYNIX_MCP_PATH (modo HTTP)

Gere um token em: https://www.vynix.in/mcp

Ferramentas, Prompts e Recursos

Referência de ferramentas: docs/tools.md
Referência de prompts: docs/prompts.md
Referência de recursos: docs/resources.md
Referência de habilidades/fluxos de trabalho: docs/skills.md
Guia de implantação: docs/deployment.md
Guia de descoberta de agentes: docs/agent-discovery.md
Arquivo de índice LLM: llms.txt
Rastreador de listagem de diretórios: docs/listings-status.md

Exemplos

Fluxos de trabalho de conversa: examples/workflows
Biblioteca de prompts (100+ prompts): examples/prompts.md

Solução de Problemas

Erro Not configured: defina VYNIX_API_TOKEN ou ambos VYNIX_API_EMAIL e VYNIX_API_PASSWORD.
Erros 401: gere um novo token e verifique a URL da API.
Nenhuma ferramenta listada: confirme a chave de configuração MCP (mcpServers vs servers) para seu cliente.
Modo hospedado inacessível: verifique VYNIX_MCP_MODE=http e confira /health.

FAQ

Isso envia dados para provedores de IA terceirizados?

Apenas diagnose_annotation pode invocar provedores de IA externos por meio da configuração do seu espaço de trabalho Vynix.

Isso é somente leitura?

Não. Inclui ferramentas de leitura e ferramentas de escrita. Anotações MCP identificam chamadas de mutação/mundo aberto para que os clientes possam solicitar confirmação.

Posso hospedar por conta própria?

Sim. Execute em modo stdio localmente ou em modo HTTP atrás da sua própria infraestrutura.

Contribuindo

Veja CONTRIBUTING.md. Para validação local, execute:

npm run check

Segurança

Nunca envie tokens de API para o repositório.
Prefira tokens de curta duração quando possível.
Veja SECURITY.md (crie um se sua organização exigir uma política de divulgação).

Licença

MIT

Changelog

CHANGELOG.md