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.

01 Capacidades

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.

02 Ligação

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.

  1. 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.

  2. 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 palavra Bearer, um espaço e depois a chave. Guarde a chave numa variável de ambiente ou num gestor de segredos, nunca num repositório.

  3. 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”.

03 Dados do servidor

Dados do servidor

Dados do servidor
ElementoValor
URL do servidorhttps://app.northboundintelligence.com/api/mcp
TransporteHTTP com streaming (streamable HTTP): JSON-RPC 2.0 sobre POST, com respostas JSON
AutenticaçãoChave de API no cabeçalho Authorization: Bearer nbk_live_.... O servidor também aceita a chave num cabeçalho X-API-Token.
HandshakeO 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ãoApenas chave de API. O início de sessão com OAuth ainda não está disponível.
Versões do protocolo2025-03-26 e 2024-11-05
04 Configuração

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.

05 Permissões

Scopes: dê à chave apenas o que ela precisa

Scopes: dê à chave apenas o que ela precisa
ScopeO que permite ao agente fazer
read_assetsLer os seus projetos, ativos, superfície descoberta e execuções de avaliações
read_findingsLer achados e o seu resumo de postura, e gerar relatórios
launch_scansIniciar avaliações. Deixe-o desativado se só quiser acesso de leitura.

Uma chave só de leitura não consegue iniciar uma avaliação.

06 Planos e créditos

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.

Em todos os planos, medido por créditos
PlanoCréditos de API por mês
Gratuito50
Avaliação gratuita500
Pro500
Business1000
Elite2000
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.

07 Salvaguardas

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.

08 Resolução de problemas

Se uma chamada falhar

Se uma chamada falhar
SintomaCausa provável
401A 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>.
402O 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 scopeA chave não tem o scope de que essa ferramenta precisa. Crie ou edite uma chave que o inclua.
429 ou limite de frequênciaDemasiadas chamadas ou lançamentos em pouco tempo. Aguarde e tente novamente.
O nome da variável é enviado tal e qualA 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.
09 O que não é

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.