Vysion MCP

npx add-mcp 'https://mcp.vysion.ai/mcp'

O servidor MCP da Vysion permite que você use a inteligência de ameaças da Vysion diretamente em assistentes de IA como Claude Code, Mistral (Le Chat), Cursor, OpenCode e outros.

Em vez de escrever código ou chamar a API REST, você conecta o servidor uma vez e depois faz perguntas em linguagem natural. O assistente decide qual ferramenta da Vysion chamar e retorna os resultados para você.

O que é MCP?

MCP (Model Context Protocol) é um padrão aberto que permite que assistentes de IA usem ferramentas e fontes de dados externas. Ao conectar o servidor MCP da Vysion, seu assistente ganha acesso à inteligência de darknet da Vysion (documentos, vazamentos, mensagens instantâneas, vítimas de ransomware, feeds e mais) como um conjunto de ferramentas que ele pode invocar em seu nome.

Pré-requisitos

• Uma chave de API da Vysion (consulte Autenticação)
• Um cliente compatível: Claude Code, Mistral / Le Chat, Cursor, OpenCode ou qualquer outro cliente compatível com MCP

Detalhes de conexão

Use os mesmos valores em todos os clientes:

Configuração	Valor
URL do servidor	https://mcp.vysion.ai/mcp
Autenticação	Sua chave de API pessoal da Vysion

Claude Code

O Claude Code oferece duas formas de adicionar o servidor MCP da Vysion: um comando de CLI ou um arquivo de configuração.

• Comando de CLI
• Arquivo de configuração

Execute o seguinte comando no seu terminal:

claude mcp add vysion \
  --transport http \
  https://mcp.vysion.ai/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Substitua YOUR_API_KEY pela sua chave de API pessoal da Vysion.

Depois de adicionar o servidor, verifique se ele está conectado executando o comando /mcp dentro do Claude Code. Você deverá ver Vysion listado com suas ferramentas.

Mistral / Le Chat

1. Abra o Mistral e vá para Connectors.
2. Clique em Add connector e selecione Add a custom connector.
3. Preencha o formulário com estes valores:

Campo	Valor
Name	Vysion
Connector Server	https://mcp.vysion.ai/mcp
Authentication	API Token Authentication
Header name	Authorization
Type	Bearer
Token	YOUR_API_KEY

4. Salve o conector e habilite-o para suas conversas.

O que você pode fazer

Depois de conectar, faça perguntas em linguagem natural. O assistente escolherá automaticamente a ferramenta correta da Vysion. Por exemplo:

• “Busque credenciais vazadas para o e-mail admin@example.com.”
• “Mostre-me vítimas de ransomware no setor de saúde dos últimos 30 dias.”
• “Encontre documentos que mencionem o grupo LockBit.”
• “Verifique se este endereço Bitcoin aparece em alguma fonte de vazamento ou da dark web.”

Ferramentas disponíveis

O servidor MCP da Vysion expõe ferramentas nestas categorias:

• Documentos: pesquisa e recuperação de documentos de inteligência de ameaças
• Vazamentos: pesquisa de dados vazados por e-mail, carteira, IP, telefone, nome de usuário ou hash
• Mensagens instantâneas: pesquisa de mensagens, canais e perfis do Telegram e do Discord
• Vítimas de ransomware: pesquisa de vítimas e grupos de ransomware
• Estatísticas e histogramas de ransomware: estatísticas por país, grupo e setor
• Feeds: feeds de ransomware, Telegram, criptomoedas e onion
• OSINT: inteligência de números de telefone

Para detalhes de endpoints e parâmetros, comece pela referência da API de Documentos e use a barra lateral API Reference para as demais categorias.

Solução de problemas

401 Unauthorized

O servidor retorna 401 quando a chave de API está ausente ou é inválida. Verifique se:

• Você substituiu YOUR_API_KEY pela sua chave real.
• O cabeçalho é Authorization: Bearer YOUR_API_KEY.

Conector não aparece no Mistral

Certifique-se de que você selecionou API Token Authentication e definiu o cabeçalho como Authorization com o tipo Bearer. O Mistral detecta o tipo de conector a partir da resposta de autenticação do servidor.

Limites de taxa

A API da Vysion tem limite de taxa. Consulte o guia de limitação de taxa para mais detalhes.