Integração do Model Context Protocol (MCP)

Com a integração do Model Context Protocol (MCP) no Amazon Quick Suite, você pode se conectar aos servidores MCP para execução de tarefas e recursos de acesso a dados. O MCP fornece uma maneira padronizada de conectar sistemas de IA com ferramentas externas e fontes de dados.

O que é possível fazer

Com a integração MCP, você pode se conectar aos servidores MCP para execução de ações e acesso a dados por meio de protocolos padronizados.

Conector de ação

Conecte-se aos servidores MCP para realizar ações e executar tarefas por meio de protocolos MCP padronizados.

Integração de acesso a dados

Acesse fontes de dados por meio de servidores MCP para criar bases de conhecimento e recuperar informações.

Antes de começar

Antes de configurar a integração do MCP, verifique se você tem o seguinte:

• Endpoint do servidor MCP com acesso apropriado.

• Credenciais de autenticação para o servidor MCP.

• Amazon Quick Suite Author ou superior para conectores de ação.

• Assinatura Amazon Quick Suite Professional

nota

A integração do MCP oferece suporte somente a servidores remotos. O streaming HTTP é preferível aos eventos enviados pelo servidor (SSE). Conexões de estúdio local não são suportadas. A conectividade VPC não é suportada.

Servidores MCP populares

Veja a seguir exemplos de servidores MCP populares usados com o Amazon Quick Suite e o servidor MCP remoto: URLs

:

Servidores MCP populares

Provedor	URL do servidor MCP
Asana	https://mcp.asana.com/sse
Atlassian	https://mcp.atlassian.com/v1/sse
AWS Servidor Knowledge MCP	https://knowledge-mcp.global.api.aws
Box	http://mcp.box.com/
HubSpot	https://mcp.hubspot.com
HuggingFace	https://huggingface.co/mcp
Intercom	https://mcp.intercom.com/mcp
Linear	https://mcp.linear.app/mcp
Segunda-feira	https://mcp.monday.com/sse
Noção	https://mcp.notion.com/mcp
PagerDuty	https://identity.pagerduty.com/global/oauth/anonymous/.well-known/openid-configuration
Workato	https://MCP_ID.apim.mcp.workato.com
Zapier	https://mcp.zapier.com/MCP_ID

A tabela de procedimentos mostra apenas alguns dos muitos MCPs compatíveis para uso com o Amazon Quick Suite.

nota

Esses servidores exigem credenciais de autenticação apropriadas. Consulte a documentação de cada provedor para obter os requisitos específicos de autenticação.

Preparar a configuração e a autenticação do servidor MCP

Antes de configurar a integração no Amazon Quick Suite, prepare suas credenciais de configuração e autenticação do servidor MCP. A integração do MCP oferece suporte a vários métodos de autenticação e abordagens de configuração. Escolha o método que corresponda aos requisitos do seu servidor MCP:

Autenticação do usuário (OAuth)

Os servidores MCP oferecem suporte a duas abordagens de configuração para OAuth autenticação:

Registro dinâmico de clientes (DCR)

Quando seu servidor MCP anuncia suporte ao Registro Dinâmico de Clientes, nenhuma configuração manual é necessária. O cliente MCP se registra automaticamente no servidor e recebe as credenciais necessárias durante o processo de conexão. Essa abordagem simplificada elimina a necessidade de reunir manualmente o cliente IDs, os segredos e o endpoint URLs.

Configuração manual

Para servidores MCP que não suportam DCR, reúna as seguintes informações da configuração do servidor MCP:

• ID do cliente - ID OAuth do cliente.

• Segredo do OAuth cliente - segredo do cliente.

• URL do token - ponto final do OAuth token.

• URL de autenticação - ponto final OAuth de autorização.

• URL de redirecionamento - URI de OAuth redirecionamento.

Autenticação de serviço (serviço a serviço)

Reúna as seguintes informações da configuração do servidor MCP:

• ID do cliente - ID do cliente do serviço.

• Segredo do cliente - Segredo do cliente do serviço.

• URL do token - ponto final do token de serviço.

Autenticação por chave de

Reúna as seguintes informações do administrador do servidor MCP:

• Chave de API - chave de API do servidor MCP.

Autenticação por nome de usuário/senha

Reúna as seguintes informações do administrador do servidor MCP:

• Nome de usuário - nome de usuário do servidor MCP.

• Senha - senha do servidor MCP.

Configurar a integração MCP

Depois de preparar a configuração do servidor MCP e as credenciais de autenticação, siga estas etapas para criar sua integração com o MCP:

1. No console do Amazon Quick Suite, escolha Integrações.

2. Clique em Adicionar (mais o botão “+”).

3. Na página Criar integração, insira os detalhes da integração:

   • Nome - Nome descritivo para sua integração com o MCP.

   • Descrição (opcional) - Objetivo da integração.

   • Endpoint do servidor MCP - URL do servidor MCP.

4. Clique em Next.

5. Selecione o método de autenticação (usuário ou serviço).

6. Forneça os detalhes de configuração apropriados.

7. Selecione Criar e continuar.

8. Revise os detalhes da integração.

9. Escolha Próximo.

10. Compartilhe a integração com outros usuários, se necessário.

Depois de criar sua integração MCP, uma base de conhecimento é criada automaticamente após a conclusão da criação da integração.

Gerencie bases de conhecimento

Depois de configurar sua integração MCP, você pode criar e gerenciar bases de conhecimento a partir de suas fontes de dados MCP.

Edite as bases de conhecimento existentes

Você pode modificar suas bases de conhecimento MCP existentes:

1. No console do Amazon Quick Suite, escolha Bases de conhecimento.

2. Selecione sua base de conhecimento MCP na lista.

3. Escolha Ações e, em seguida, escolha Editar base de conhecimento.

4. Atualize suas configurações conforme necessário e escolha Salvar.

Crie bases de conhecimento adicionais

Você pode criar várias bases de conhecimento a partir da mesma integração MCP:

1. No console do Amazon Quick Suite, escolha Integrações.

2. Escolha sua integração MCP existente na lista.

3. Escolha Ações e, em seguida, escolha Criar base de conhecimento.

4. Defina as configurações da sua base de conhecimento e escolha Criar.

Para obter informações detalhadas sobre as opções de configuração da base de conhecimento, consulteConfigurações comuns.

Revise a integração

Depois de configurar a autenticação, revise os recursos de integração do MCP:

1. O sistema se conecta ao servidor MCP e descobre os recursos disponíveis.

2. Examine a lista de ações e tarefas disponíveis fornecidas pelo servidor MCP.

3. Verifique os recursos de acesso aos dados se o servidor MCP fornecer fontes de dados.

4. Confirme a configuração e os recursos da integração.

Descoberta de capacidades

A integração do MCP descobre e lista automaticamente:

• Ferramentas e ações disponíveis.

• Fontes e recursos de dados.

• Protocolos e métodos suportados.

• Metadados e recursos do servidor.

Gerencie integrações MCP

Depois de criar sua integração MCP, você pode gerenciá-la usando estas opções:

• Compartilhe a integração - Disponibilize a integração para outros usuários em sua organização.

• Ferramentas de revisão - Ferramentas de revisão que estão habilitadas.

nota

As integrações MCP dependem da disponibilidade e da configuração do servidor MCP de destino. Alterações no servidor ou nos requisitos de autenticação podem afetar a funcionalidade de integração.

Limitações

Ao usar integrações de MCP no Amazon Quick Suite, esteja ciente das seguintes limitações:

• As operações de MCP têm um tempo limite fixo de 60 segundos. As operações que excedem esse limite falham automaticamente com um erro HTTP 424.

• Os cabeçalhos HTTP personalizados não são suportados nas operações do MCP. Somente cabeçalhos padrão do sistema são transmitidos.

• As listas de ferramentas permanecem estáticas após o registro inicial. Você deve atualizar manualmente as ações para detectar alterações no servidor.

• A criação do conector pode falhar se o URI de retorno de chamada do Amazon Quick Suite não for permitido por provedores terceirizados.

• Problemas de conectividade do servidor resultam em falha imediata sem novas tentativas.