Usar Claude Code e Cursor com AI-FW e MCP

Usar Claude Code e Cursor com AI-FW e MCP

Configure Cursor Agent Hooks, roteie Claude Code pelo gateway e conecte clientes MCP com identidade e auditoria.

O AI-FW governa chamadas de modelos e ferramentas em ambientes de programação compatíveis. Siga as políticas da organização para credenciais, repositórios e ferramentas.

Claude Code#

Configure o endpoint compatível com OpenAI do gateway como provedor. Use API key atribuída ao agente e registre Agent ID com permissões necessárias. Confirme que o modelo está habilitado no Model Inventory.

As solicitações passam pelos guardrails e são registradas com a identidade do agente. Não compartilhe API keys entre agentes.

Cursor Agent Hooks#

Configure Cursor para enviar eventos ao endpoint Cursor Agent Hooks. Em Settings -> Integrations, habilite a integração e configure o segredo webhook. Proteja o segredo e use HTTPS público acessível pelo Cursor.

AI-FW valida a assinatura, avalia a política e registra decisão e metadados. Teste em ambiente controlado e confira Audit Logs.

Ferramentas MCP#

Configure o cliente MCP para conectar ao endpoint governado. Registre a identidade e autorize apenas ferramentas necessárias. Separe permissões de leitura e escrita e revise chamadas na auditoria.

Verificar#

  1. Envie solicitação de teste com modelo aprovado.
  2. Confirme Agent ID e modelo em Activity.
  3. Teste ação bloqueada e verifique evento de política.
  4. Revise Audit Logs para solicitações e chamadas de ferramentas.
  5. Faça rotação ou revogue credenciais de teste após o uso.
Proteja segredos e repositórios

Não salve API keys ou segredos webhook em arquivos versionados ou instruções compartilhadas. Restrinja acesso a ferramentas de escrita.

Próximas leituras#

Próximas leituras