Plataforma · Para programadores
Ligue o seu agente de IA ao NorthBound Sentinel
O servidor MCP do NorthBound Sentinel é um servidor remoto do Model Context Protocol (MCP). Ligue o seu agente de IA para programar e o assistente que escreve o seu código também poderá ler a sua superfície de ataque e os seus achados, e iniciar uma avaliação num domínio seu. Está aberto a todos os planos e é medido por créditos.
O que o seu agente pode fazer
Os nomes exatos das ferramentas e os respetivos parâmetros são publicados pelo próprio servidor (tools/list), pelo que o seu cliente mostra sempre o conjunto em vigor. Em termos simples:
-
Ver o seu inventário
Liste os seus projetos e domínios, com o estado de verificação da titularidade de cada domínio e o número de achados em aberto.
-
Ver a sua superfície exposta
Para um domínio, obtenha o mapa da aplicação que a plataforma descobriu, os seus endpoints e as tecnologias que utiliza, juntamente com alertas de vulnerabilidades conhecidas.
-
Ler achados
Pesquise e filtre achados por projeto, domínio, severidade, estado ou palavra-chave, e abra um para ver a sua evidência, o nível de prova, a pontuação de severidade e as orientações de correção.
-
Obter um resumo de postura
Achados em aberto por severidade, que parte do seu inventário tem a titularidade verificada, prazos de correção que estão a derrapar e o que há de mais importante a corrigir a seguir.
-
Acompanhar e lançar avaliações
Liste avaliações passadas e em curso, consulte o estado de uma ou lance uma avaliação num domínio seu, com as salvaguardas descritas abaixo.
-
Gerar relatórios
Produza um relatório de um projeto ou de um único domínio como resumo estruturado, documento HTML autónomo ou PDF com assinatura digital.
Ligue-se em três passos
Utilize-o a partir do Claude Code, do Cursor, do VS Code ou de qualquer outro cliente MCP que suporte servidores HTTP remotos com cabeçalhos personalizados.
-
Crie uma chave de API
Na aplicação, abra Settings > API Credentials e crie uma credencial. Escolha apenas as permissões (scopes) de que precisa e, se quiser, restrinja a chave a uma lista de IP permitidos. A chave começa por
nbk_live_e é mostrada uma única vez, por isso copie-a de imediato. Se a perder, rode-a ou crie uma nova. -
Adicione o servidor ao seu cliente
Adicione o servidor ao Claude Code, ao Cursor, ao VS Code ou a qualquer outro cliente MCP (configuração abaixo). Use o URL do servidor e envie a chave no cabeçalho
Authorization: a palavraBearer, um espaço e depois a chave. Guarde a chave numa variável de ambiente ou num gestor de segredos, nunca num repositório. -
Peça ao seu agente
Por exemplo: “Liste os meus ativos da NorthBound e diga-me quais têm achados em aberto de severidade alta ou crítica”. Ou: “Mostre-me a evidência e as orientações de correção desse achado e proponha um patch”. Ou: “Inicie uma avaliação passiva em staging.acme.example e avise-me quando terminar”.
Dados do servidor
| Elemento | Valor |
|---|---|
| URL do servidor | https://app.northboundintelligence.com/api/mcp |
| Transporte | HTTP com streaming (streamable HTTP): JSON-RPC 2.0 sobre POST, com respostas JSON |
| Autenticação | Chave de API no cabeçalho Authorization: Bearer nbk_live_.... O servidor também aceita a chave num cabeçalho X-API-Token. |
| Handshake | O handshake (initialize e tools/list) é público, pelo que um cliente consegue ver o que está disponível. Para chamar uma ferramenta é necessária uma chave válida. |
| Início de sessão | Apenas chave de API. O início de sessão com OAuth ainda não está disponível. |
| Versões do protocolo | 2025-03-26 e 2024-11-05 |
Configure o seu cliente
Guarde a chave numa variável de ambiente chamada NORTHBOUND_API_KEY e depois adicione o servidor ao seu cliente. O valor do cabeçalho é a palavra Bearer, um espaço e depois a chave. Os nomes das chaves variam ligeiramente entre clientes; estas são as configurações que funcionam nos três mais comuns.
Defina a sua chave no ambiente
export NORTHBOUND_API_KEY="nbk_live_..."Claude Code: um único comando
claude mcp add --transport http northbound-sentinel \
https://app.northboundintelligence.com/api/mcp \
--header "Authorization: Bearer $NORTHBOUND_API_KEY"Claude Code: .mcp.json na raiz do projeto
{
"mcpServers": {
"northbound-sentinel": {
"type": "http",
"url": "https://app.northboundintelligence.com/api/mcp",
"headers": {
"Authorization": "Bearer ${NORTHBOUND_API_KEY}"
}
}
}
}Cursor: ~/.cursor/mcp.json (todos os projetos) ou .cursor/mcp.json (este projeto)
{
"mcpServers": {
"northbound-sentinel": {
"url": "https://app.northboundintelligence.com/api/mcp",
"headers": {
"Authorization": "Bearer ${env:NORTHBOUND_API_KEY}"
}
}
}
}VS Code: .vscode/mcp.json
{
"inputs": [
{
"type": "promptString",
"id": "northbound-api-key",
"description": "NorthBound API key (nbk_live_...)",
"password": true
}
],
"servers": {
"northbound-sentinel": {
"type": "http",
"url": "https://app.northboundintelligence.com/api/mcp",
"headers": {
"Authorization": "Bearer ${input:northbound-api-key}"
}
}
}
}Liste as ferramentas a partir de um terminal
curl -sS https://app.northboundintelligence.com/api/mcp \
-H "Authorization: Bearer $NORTHBOUND_API_KEY" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'Claude Code: a opção de um único comando guarda a chave já expandida na sua configuração local do Claude Code, enquanto a opção .mcp.json guarda apenas uma referência, pelo que é seguro enviá-la para o repositório. O Cursor resolve ${env:NAME} e precisa de que o processo do Cursor veja a variável; reinicie-o depois de a alterar. O VS Code usa servers como chave raiz, e não mcpServers, e pode pedir-lhe a chave para que nunca fique escrita no ficheiro. Depois confirme que o servidor aparece como ligado: claude mcp list (ou /mcp dentro do Claude Code), a secção MCP nas definições do Cursor, ou MCP: List Servers no VS Code.
Scopes: dê à chave apenas o que ela precisa
| Scope | O que permite ao agente fazer |
|---|---|
read_assets | Ler os seus projetos, ativos, superfície descoberta e execuções de avaliações |
read_findings | Ler achados e o seu resumo de postura, e gerar relatórios |
launch_scans | Iniciar avaliações. Deixe-o desativado se só quiser acesso de leitura. |
Uma chave só de leitura não consegue iniciar uma avaliação.
Em todos os planos, medido por créditos
O acesso por MCP não está reservado a um plano em particular. Todos os planos incluem uma quota mensal de créditos de API, e as chamadas a ferramentas consomem-nos.
| Plano | Créditos de API por mês |
|---|---|
| Gratuito | 50 |
| Avaliação gratuita | 500 |
| Pro | 500 |
| Business | 1000 |
| Elite | 2000 |
| Corporativo | À medida da sua organização |
Se o seu plano ou a quota restante não cobrirem uma chamada, o servidor responde 402. Consulte os planos.
Salvaguardas incorporadas no servidor
O seu agente trabalha sob as mesmas regras que o resto da plataforma.
-
Apenas os seus dados
Cada chamada fica limitada à sua própria conta. Os resultados nunca incluem dados de outro cliente.
-
Privilégio mínimo
As chaves têm scopes. Uma chave só de leitura não consegue iniciar uma avaliação.
-
Primeiro a titularidade
Tudo o que seja mais ativo do que a observação passiva exige titularidade verificada do domínio. Os domínios por verificar só aceitam avaliações passivas.
-
Uma pessoa confirma a autorização
Lançar uma avaliação exige uma confirmação explícita de que está legalmente autorizado a testar o alvo, registada na auditoria. O seu agente tem de lhe perguntar; não deve confirmar por conta própria.
-
Uma de cada vez e com limite de frequência
As avaliações executam-se uma após outra por utilizador, com um lançamento por pedido, e as chamadas têm limite de frequência por chave.
-
Resultados adequados a clientes
Os resultados usam a mesma linguagem orientada ao cliente que a aplicação e os relatórios da NorthBound.
Se uma chamada falhar
| Sintoma | Causa provável |
|---|---|
401 | A chave está em falta, mal escrita, expirada ou revogada; o pedido vem de um IP fora da lista permitida da chave; ou o cabeçalho não é Authorization: Bearer <chave>. |
402 | O seu plano atual ou a sua quota de utilização não cobre a chamada. Verifique o seu plano e os seus créditos na aplicação. |
| Insufficient scope | A chave não tem o scope de que essa ferramenta precisa. Crie ou edite uma chave que o inclua. |
429 ou limite de frequência | Demasiadas chamadas ou lançamentos em pouco tempo. Aguarde e tente novamente. |
| O nome da variável é enviado tal e qual | A variável de ambiente não está definida no processo que iniciou o seu cliente. O Claude Code avisa e envia o texto literal, que o servidor rejeita com 401. |
O que é isto e o que não é
A NorthBound é uma equipa de segurança liderada por pessoas e assistida por IA. Este servidor dá ao seu agente acesso governado aos seus próprios resultados e às avaliações que está autorizado a executar. Apoia a sua revisão; não a substitui, e não é uma certificação de conformidade nem uma afirmação de que um sistema é seguro.
As avaliações executam-se apenas em domínios que são seus ou que está autorizado a testar. Para reportar uma vulnerabilidade na própria NorthBound, consulte como a reportar.
Crie uma chave e ligue o seu agente.
Inicie sessão na aplicação, abra Settings e depois API Credentials. Dúvidas sobre o acesso ou os planos? Escreva para contact@northboundintelligence.com.
Dados desta página verificados a 11 de novembro de 2026.