Ir para o conteúdo principal
Português— Escolher um idioma
Menu

Segurança e Melhores Práticas

Aula 11 de 12 Atualizada a 29 de julho de 2026 Programador
Nesta página
  1. O Que a Ligação a um Servidor Permite
  2. HTTPS e Autenticação: A Base Não Negociável
  3. Listas de Permissão como Segunda Linha de Defesa
  4. O Contexto É Um Recurso Finito
  5. Descrições Que Melhoram a Precisão
  6. Pontos-chave

O Que a Ligação a um Servidor Permite

Ligar o Grok a servidores MCP remotos confere ao modelo a capacidade de atuar nos seus sistemas. Este poder acarreta riscos, e as lições anteriores apresentaram os parâmetros que o controlam. Chegou agora o momento de os organizar numa postura de segurança coerente para implementação em produção.

HTTPS e Autenticação: A Base Não Negociável

A regra é simples: todo o servidor MCP em produção deve utilizar HTTPS e exigir autenticação. A xAI já impõe o primeiro ponto e rejeita quaisquer URLs HTTP simples. O segundo, contudo, depende inteiramente de si, e é aí que os erros se infiltram.

Um servidor sem autenticação está acessível a qualquer pessoa que conheça o URL. Isto significa que qualquer um pode invocar as suas ferramentas internas, os seus dados circulam sem controlo de acesso e não tem forma de rastrear quem fez o quê quando ocorre uma anomalia. O URL não é um segredo: viaja pelas redes, acaba nos registos (logs) e é adivinhável se seguir uma convenção.

# Produção: SEMPRE com autenticação
mcp(
    server_url="https://api.monentreprise.com/mcp",
    server_label="interne",
    authorization=f"Bearer {os.getenv('MCP_TOKEN')}"
)

# Apenas Desenvolvimento: sem autenticação
# NUNCA implementar em produção
mcp(
    server_url="https://mcp.deepwiki.com/mcp",
    server_label="deepwiki"
)

A gestão de tokens segue quatro disciplinas simples, mas deve mantê-las ao longo do tempo. Armazene os tokens em variáveis de ambiente, nunca no código fonte. Caso contrário, o seu primeiro git push público envia o seu token para o mundo. Rode-os periodicamente, pelo menos a cada 90 dias. Uma rotação agendada transforma uma potencial fuga numa janela de exposição limitada. Gere-os com as permissões mínimas necessárias, para que um token roubado para um agente de apenas leitura seja inútil para quem tentar escrever. Se um for comprometido, revogue-o imediatamente antes de gerar um novo. A ordem importa: um token revogado a posteriori continua a funcionar durante todo o tempo que gastar à procura da sua substituição.

Listas de Permissão como Segunda Linha de Defesa

Um token válido prova a identidade do chamador; nada diz sobre o que o chamador deve poder fazer. É aqui que entra o allowed_tool_names. Aplica o princípio do privilégio mínimo, expondo apenas o estritamente necessário ao modelo.

A restrição específica depende do perfil do agente. Um chatbot público limita-se a operações de apenas leitura, sem ferramentas de escrita ao seu alcance.

allowed_tool_names=["search_docs", "get_article", "list_categories"]
# Sem acesso a: create_article, update_article, delete_article

Um agente interno pode permitir-se mais acesso, incluindo comentar um ticket, mantendo porém ações irreversíveis ou ações visíveis a terceiros fora do seu alcance.

allowed_tool_names=[
    "search_tickets", "get_ticket", "add_comment",
    # Sem acesso a: close_ticket, delete_ticket, reassign_ticket
]

Por fim, um pipeline automatizado só precisa das duas ferramentas que a sua workflow encadeia. Não há justificação para que reconfigure qualquer coisa.

allowed_tool_names=["run_analysis", "get_results"]
# Sem acesso a: configure_pipeline, delete_results

O cenário contra o qual estas listas o protegem é a injeção de prompts. Um documento analisado, um ticket ou um e-mail recebido pode conter uma instrução destinada ao modelo. Sem restrição, esta instrução pode levá-lo a eliminar dados através de uma ferramenta delete_*, modificar uma configuração via update_config ou emitir comunicações indesejadas via send_email. Uma ferramenta que nunca foi exposta não pode ser sequestrada. Esta é a única garantia verdadeiramente sólida.

O Contexto É Um Recurso Finito

Cada ferramenta exposta consome tokens na janela de contexto, uma vez que o seu nome, descrição e esquema de parâmetros devem lá residir. Um servidor que publica trinta ferramentas pode consumir vários milhares de tokens antes mesmo de o utilizador fazer uma pergunta.

As consequências manifestam-se de três formas: menos espaço para a própria conversa, tempo de processamento mais longo devido ao volume a analisar e um risco acrescido de confusão quando múltiplas ferramentas se assemelham. Três práticas abordam esta questão. Primeiro, restrinja com allowed_tool_names, que permanece a alavanca mais direta. Em seguida, segmente por caso de uso em vez de manter uma única configuração. Um agente de apoio ao cliente, um agente interno e um pipeline não têm razão para partilhar o mesmo catálogo. Por fim, reavalie periodicamente. Verifique os seus registos (traces) para ver quais as ferramentas realmente invocadas. Frequentemente, encontrará várias que nunca foram usadas, mas que custam contexto em cada pedido.

Descrições Que Melhoram a Precisão

Descrições cuidadosas, tanto ao nível do servidor como da ferramenta, reduzem mensuravelmente as chamadas erróneas. O contraste abaixo ilustra a diferença entre uma descrição utilizável e uma inútil.

# Bom: específico e acionável
server_description="Base de conhecimento de produtos. Pesquise artigos de ajuda, FAQ e guias de resolução de problemas para os produtos A, B e C."

# Mau: vago e genérico
server_description="Base de dados"

O prompt do sistema é a camada final desta configuração. Permite-lhe expressar regras de utilização que a configuração por si só não consegue impor, como uma ordem de prioridade entre fontes ou um requisito de confirmação.

Quando o utilizador fizer uma pergunta técnica, pesquise primeiro na base de conhecimento interna (kb).
Se a resposta não for encontrada, utilize a pesquisa na web como suplemento.
Nunca modifique um ticket sem confirmação explícita do utilizador.

Tenha em mente, contudo, que estas diretrizes orientam o comportamento do modelo sem o constranger. Complementam a lista de permissão; nunca a substituem.

Pontos-chave

  • O HTTPS é imposto pela xAI, mas a autenticação é da sua responsabilidade
  • Armazene tokens em variáveis de ambiente e rode-os regularmente
  • Utilize allowed_tool_names para aplicar o princípio do privilégio mínimo
  • Monitore a carga de contexto: cada ferramenta consome tokens
  • Escreva descrições precisas para melhorar a seleção de ferramentas do Grok