Adicionar servidor MCP personalizado

Conectar um servidor MCP personalizado

Conecte seu servidor Model Context Protocol (MCP) ao ChatGPT como plugin. O ChatGPT oferece suporte às ferramentas de leitura e de gravação do seu servidor.

Conecte-se apenas a servidores MCP em que você confia. Um servidor não confiável pode acessar ou roubar informações compartilhadas durante o uso de um aplicativo ou induzir o ChatGPT a usar ferramentas de maneiras imprevistas, inclusive para alterar ou excluir dados. Antes de conectar um servidor, leia sobre injeções de prompt e outros riscos.

Como usar

• Acesso: Use o ChatGPT na Web. As permissões do espaço de trabalho e as restrições de segurança, incluindo o Modo de bloqueio, se aplicam à adição e ao uso de servidores MCP personalizados.

• Adicionar um servidor MCP como plugin:

  1. Acesse Plug-ins do ChatGPT.
  2. Selecione o botão com o sinal de mais e depois Adicionar servidor MCP personalizado.
  3. Insira um nome e, se quiser, uma descrição. Em Conexão, insira a URL do servidor ou selecione Túnel para usar um túnel MCP seguro.
  4. Configure a autenticação do servidor.
  5. Leia o aviso de risco e selecione Entendo e quero continuar.
  6. Selecione Criar como plugin.
  • Protocolos MCP compatíveis: SSE e HTTP com streaming.
  • As opções de autenticação incluem OAuth, Sem autenticação e OAuth ou sem autenticação.
    • Se forem fornecidas credenciais estáticas para OAuth, o ChatGPT usará essas credenciais. Caso contrário, o ChatGPT poderá usar documentos de metadados do ID do cliente (CIMD) se o servidor de autorização indicar suporte a esse recurso e o criador do aplicativo escolher CIMD. O CIMD permite a troca de tokens para clientes públicos (none) e a troca de tokens com uma declaração assinada pelo cliente (private_key_jwt). O ChatGPT também pode usar DCR se essa opção estiver configurada.
    • A autenticação mista permite usar OAuth ou dispensar a autenticação. Nesse modo, as APIs de inicialização e de listagem de ferramentas dispensam a autenticação. Cada ferramenta usa OAuth ou dispensa a autenticação conforme os esquemas de segurança definidos nos seus metadados.
  • Você encontrará o plugin entre seus plugins pessoais ou no espaço de trabalho em que o criou. Instale-o antes de usá-lo em uma conversa.

• Gerenciar ferramentas: Nas configurações de aplicativos, cada aplicativo tem uma página de detalhes. Nessa página, você pode ativar ou desativar ferramentas e atualizar o aplicativo para obter novas ferramentas, descrições e instruções do servidor MCP.

• Usar aplicativos em conversas: No campo de mensagem, digite @ e selecione o plugin instalado. Você pode usar plugins MCP personalizados junto com outros aplicativos, respeitando as permissões do espaço de trabalho e as restrições de segurança. Talvez seja preciso experimentar diferentes maneiras de formular o prompt para chamar as ferramentas certas. Por exemplo:

  • Diga exatamente qual ferramenta usar: Use a ferramenta "update_record" do aplicativo "Acme CRM" para …. Quando necessário, inclua o rótulo do servidor e o nome da ferramenta.
  • Descarte as alternativas para evitar ambiguidades: “Use apenas o aplicativo Acme CRM. Não use a navegação integrada nem outras ferramentas.”
  • Diferencie ferramentas semelhantes: “Dê preferência a Calendar.create_event para reuniões. Não use Reminders.create_task para agendamentos.”
  • Especifique o formato da entrada e a ordem das chamadas: “Primeiro, chame Repo.read_file com { path: "…" }. Depois, chame Repo.write_file com o conteúdo modificado. Não chame outras ferramentas.”
  • Se vários aplicativos tiverem funções semelhantes, indique suas preferências logo no início (por exemplo, “Use CompanyDB como fonte de referência. Só consulte outras fontes se CompanyDB não retornar resultados”).
  • Servidores MCP personalizados não exigem as ferramentas search/fetch. Todas as ferramentas que seu aplicativo disponibiliza (inclusive as que executam ações de gravação) podem ser usadas, conforme as configurações de confirmação.
  • Para mais orientações, consulte Uso de ferramentas e Como escrever prompts.
  • Melhore a seleção de ferramentas com descrições mais precisas: no servidor MCP, dê às ferramentas nomes e descrições que indiquem a ação executada. Inclua orientações como “Use esta ferramenta quando…”, indique os casos em que o uso é proibido e os casos extremos, e descreva os parâmetros e suas enumerações. Isso ajuda o modelo a escolher a ferramenta certa entre opções semelhantes e a evitar ferramentas integradas quando elas forem inadequadas.
  • Adicione instruções ao servidor para orientar o uso conjunto das ferramentas: use o campo instructions do MCP para orientações válidas para todo o servidor, como a ordem obrigatória das chamadas, os limites de taxa compartilhados ou as relações entre ferramentas. Os primeiros 512 caracteres devem fazer sentido por si só.

  Exemplos:

  Agende uma reunião de 30 minutos para amanhã às 15h (horário do Pacífico) com
  alice@example.com e bob@example.com usando "Calendar.create_event".
  Não use nenhuma outra ferramenta de agendamento.

  Use "GitHub.open_pull_request" para criar um pull request da branch
  "feat-retry" para "main" com o título "Add retry logic" e o corpo "…".
  Não faça push diretamente para main.

• Revisar e confirmar chamadas de ferramentas:

  • Examine os dados JSON das chamadas de ferramentas para verificar se estão corretos e diagnosticar problemas. Expanda os detalhes de cada chamada para ver o conteúdo JSON completo da entrada e da saída da ferramenta.
  • Por padrão, as ações de gravação exigem confirmação. Antes de confirmar, revise com cuidado os dados de entrada que serão enviados à ferramenta e verifique se a ação terá o efeito desejado. Uma ação de gravação incorreta pode destruir, alterar ou compartilhar dados por engano!
  • Detecção de ferramentas somente leitura: o ChatGPT respeita a anotação readOnlyHint da ferramenta (consulte as anotações de ferramentas MCP). O ChatGPT trata ferramentas sem essa anotação como ações de gravação.
  • Você pode optar por salvar a decisão de aprovar ou negar o uso de uma ferramenta pelo restante da conversa. Só salve a aprovação se conhecer o aplicativo responsável pela ferramenta e confiar nele para executar outras ações de gravação sem pedir sua aprovação. Em uma nova conversa, o ChatGPT voltará a pedir confirmação. Se você recarregar a mesma conversa, o ChatGPT também voltará a pedir confirmação nas interações seguintes.