MCP Anthropic — Escopos Ampliados

O endpoint MCP para Anthropic fornece aos clientes Claude acesso baseado em OAuth a 625 operações em 40 domínios. Isso representa uma expansão significativa em relação à superfície de escopo limitado disponível por meio do endpoint MCP universal original.

Este artigo explica as principais funcionalidades, o processo de configuração e a arquitetura técnica do endpoint Anthropic MCP, incluindo a seleção de escopo controlada pelo usuário, o padrão de fachada de 5 ferramentas e o isolamento OAuth por cliente.

O que é o MCP de Alto Nível para Anthropic?

O MCP para Anthropic é um endpoint do Protocolo de Contexto de Modelo (MCP) baseado em OAuth, projetado especificamente para clientes Claude. O MCP permite que assistentes de IA como o Claude se conectem a fontes de dados e ferramentas externas por meio de uma interface padronizada.

Este endpoint fornece acesso ao catálogo completo de operações — 625 operações em 40 domínios — representando uma expansão substancial em relação ao escopo limitado do endpoint universal original do MCP. O endpoint Anthropic utiliza um aplicativo OAuth dedicado que concede o conjunto de permissões mais amplo disponível, mantendo o controle total do usuário sobre quais permissões são concedidas.

O endpoint segue um padrão MCP por cliente, com a seguinte estrutura de URL: https://services.leadconnectorhq.com/mcp/anthropic/v2

Essa abordagem permite que diferentes clientes de IA mantenham concessões OAuth isoladas, garantindo que os escopos concedidos a Claude permaneçam separados dos escopos concedidos a outros clientes, como o ChatGPT ou futuras integrações.

Principais características e funcionalidades

O MCP para Anthropic introduz diversas funcionalidades avançadas concebidas para proporcionar um acesso abrangente à API, mantendo a segurança e a eficiência:

• Escopo ampliado — Acesso ao conjunto de escopos mais amplo disponível, abrangendo todo o catálogo de operações em 40 domínios, em comparação com a superfície de escopo limitado do endpoint original.
• Seleção de escopo controlada pelo usuário — Os usuários aprovam exatamente quais escopos a integração pode acessar por meio da tela de consentimento do OAuth, mantendo o controle total sobre as permissões.
• Padrão de fachada de 5 ferramentas — Em vez de centenas de ferramentas individuais, uma interface compacta com cinco ferramentas principais (buscar, buscar, operações de busca, descrever operação, executar operação) mantém o contexto do modelo pequeno, ao mesmo tempo que permite acesso completo ao catálogo.
• Isolamento OAuth por Cliente — Os escopos concedidos a Claude permanecem isolados dos escopos concedidos a outros clientes de IA, com aplicativos OAuth dedicados para cada cliente oficial.
• Documentação mais recente da API v3 — Todas as operações são baseadas na API v3 mais recente com aplicação completa de RBAC (Controle de Acesso Baseado em Funções).
• Conexões em nível de subconta — Cada conexão opera no nível da localização; uma conexão corresponde a uma localização, nunca à agência como um todo.

Como funciona a fachada de 5 ferramentas: os agentes descobrem e executam operações usando o padrão: search_operations → describe_operation → execute_operation. Essa arquitetura mantém a janela de contexto do modelo eficiente, ao mesmo tempo que fornece acesso ao catálogo completo de operações.

Clientes suportados pelo Claude

O endpoint MCP para Anthropic é compatível com os seguintes clientes Claude:

• Claude.ai — A interface web do Claude da Anthropic
• Claude Code — Ambiente de desenvolvimento focado em código, criado por Claude
• Claude Cowork — o ambiente de trabalho colaborativo de Claude
• Futuros clientes

O suporte para outros clientes de IA está em desenvolvimento, incluindo OpenAI, Cursor, Windsurf e VS Code. Esses clientes seguirão o mesmo padrão por cliente, com concessões OAuth isoladas.

Abrangência e Escopo da Operação

O MCP para Anthropic oferece acesso abrangente às operações do sistema. A tabela a seguir resume o catálogo completo de operações:

Principais características da cobertura da operação:

• Filtragem automática — As operações são filtradas automaticamente com base na autorização OAuth do usuário, garantindo que os usuários acessem apenas recursos permitidos.
• Conjunto de escopos mais amplo — O aplicativo Anthropic OAuth expõe o conjunto completo de escopos em todo o catálogo.
• Conexões em nível de localização — Cada conexão opera no nível da subconta/localização; uma conexão equivale a uma localização, nunca à agência como um todo.
• Seleção controlada pelo usuário — Os usuários escolhem quais escopos conceder por meio do consentimento OAuth ou da criação de um token de integração privado.

Comparação de endpoints legados: o endpoint /mcp/ legado oferece um subconjunto limitado de operações por meio do fluxo de Token de Integração Privada. Para acesso completo ao catálogo com clientes Claude, use o endpoint específico da Anthropic.

Como configurar o MCP para Anthropic

A configuração do MCP para Anthropic envolve configurar seu cliente Claude para se conectar ao endpoint específico da Anthropic e concluir o fluxo de autorização OAuth.

Arquitetura Técnica

O MCP para Anthropic implementa diversos padrões arquitetônicos avançados para fornecer integração de IA segura, escalável e eficiente:

Registro de operações hospedadas

Um registro gerado contendo todas as operações de CRM hospedadas proporciona uma descoberta de operações mais rápida, melhor classificação de operações, roteamento de execução consistente e maior precisão na seleção de ferramentas de IA.

Registro de aplicativos OAuth por cliente

Um registro de aplicativos OAuth upstream resolve um aplicativo OAuth dedicado para cada cliente oficial por trás do padrão /mcp/{client}/v2. A identidade do cliente é detectada a partir de sinais de origem e redirecionamento, com incompatibilidades de caminho com escopo rejeitadas e metadados de descoberta OAuth por cliente fornecidos.

Melhorias de segurança

A arquitetura impõe listas de permissões de URIs de redirecionamento, realiza a validação da origem MCP para evitar ataques de rebinding de DNS, aplica a redação de tokens e segredos sensíveis e isola as superfícies internas de administração/depuração dos endpoints públicos de tempo de execução.

Infraestrutura e Confiabilidade

O sistema utiliza infraestrutura Redis dedicada para serviços MCP, gerencia segredos OAuth por meio do AWS Secrets Manager e injeta automaticamente o locationId das concessões OAuth nas chamadas de API.

Aplicação do RBAC

Todas as operações são baseadas na documentação mais recente da API v3, com aplicação completa do Controle de Acesso Baseado em Funções (RBAC). As operações que falham nas verificações de RBAC são bloqueadas, garantindo que os usuários acessem apenas os recursos permitidos por sua função e concessão OAuth.

Artigos relacionados

• Documentação MCP de Alto Nível
• Entendendo os escopos do OAuth
• Referência da API de Alto Nível v3