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.

GitHub

Experimente 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: inspecione feedback, diagnostique, gere prompts de codificação, crie issues no GitHub, atualize status, comente.
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.

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"
      }
    }
  }
}

Os 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

Consulte 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 (mais de 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: regenere o 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

Este servidor envia dados a provedores de IA terceirizados?

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

É somente leitura?

Não. Inclui ferramentas de leitura e de escrita. As anotações MCP identificam chamadas mutáveis/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 de sua própria infraestrutura.

Contribuição

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

npm run check

Segurança

Nunca faça commit de tokens de API.
Prefira tokens de curta duração quando possível.
Consulte SECURITY.md (crie um se sua organização exigir uma política de divulgação).

Licença

MIT

Changelog

CHANGELOG.md