Visão geral#
MCP (Model Context Protocol) é um protocolo aberto para estabelecer comunicação padronizada entre aplicações de modelos de linguagem grandes (LLM) e fontes de dados e ferramentas externas. O Apidog possui um Cliente MCP integrado que oferece suporte à depuração e ao teste de Servidores MCP.Os Servidores MCP fornecem três recursos principais, todos com suporte para depuração pelo Cliente MCP do Apidog:Tools: Funções executáveis no lado do servidor
Prompts: Modelos de prompt predefinidos
Resources: Recursos de dados fornecidos pelo servidor
STDIO: Comunicação via entrada/saída padrão, adequada para processos locais
HTTP: Comunicação via HTTP transmitível, adequada para servidores remotos
Use a versão web ou baixe a versão mais recente do aplicativo desktop na página inicial.
Criar Cliente MCP#
Crie um novo endpoint em um projeto HTTP e selecione MCP.
Conectar-se ao Servidor MCP#
Inserir endereço do servidor#
O Apidog oferece suporte a várias maneiras de inserir informações de conexão do Servidor MCP:Entrada direta de comando ou URLAo colar um comando de terminal, o protocolo muda automaticamente para STDIO:Ao colar uma URL, o protocolo muda automaticamente para HTTP:https://example-server.modelcontextprotocol.io/mcp
{
"mcpServers": {
"Everything Server": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-everything"],
"env": {}
}
}
}
{
"type": "streamable-http",
"url": "https://example-server.modelcontextprotocol.io/mcp"
}
Estabelecer conexão#
Clique no botão Connect para iniciar a conexão.Como a execução de comando local é necessária, o Apidog exibirá uma caixa de diálogo de confirmação de segurança. Após a confirmação, ele iniciará o processo local e estabelecerá a conexão.Envie uma requisição de conexão diretamente para a URL especificada.Para Servidores MCP com autenticação OAuth 2.0, o Apidog recuperará automaticamente a configuração de autenticação e exibirá a janela de autenticação
Outros métodos de autenticação (API Key, Bearer Token, Basic Auth etc.) também podem ser configurados manualmente na aba Auth
Recursos de depuração#
Tools são funções executáveis fornecidas pelo servidor. Depois de selecionar uma Tool, você pode configurar parâmetros por meio de formulário ou editor JSON.Depois de configurar os parâmetros, clique em Run para executar. Os resultados serão exibidos na área de resposta.Prompts#
Prompts são modelos de prompt predefinidos. Depois de selecionar um Prompt, configure os parâmetros (se houver) e clique em Run para obter o prompt gerado.Resources#
Resources são recursos de dados fornecidos pelo servidor. Depois de selecionar um Resource, clique em Run para recuperar o conteúdo do recurso.
Opções de configuração#
Ambiente#
Disponível somente para o modo STDIO. Usado para configurar variáveis de ambiente ao iniciar o processo do Servidor MCP.| Chave | Valor |
|---|
| ACCESS_TOKEN | your-token-here |
| NODE_ENV | production |
Auth#
Disponível somente para o modo HTTP. Oferece suporte a vários métodos de autenticação:Para Servidores MCP compatíveis com OAuth 2.0, o Apidog pode recuperar e preencher automaticamente a configuração de autenticação.Cabeçalhos#
Disponível somente para o modo HTTP. Usado para configurar cabeçalhos personalizados de requisições HTTP.
Visualizar resposta#
Depois de clicar em Run, os resultados da execução da ferramenta serão exibidos no painel Response. O Apidog classifica a interação em dois tipos: Messages e Notifications.Messages#
Uma Message representa uma interação padrão de requisição-resposta (por exemplo, executar uma ferramenta e receber um resultado).Para cada mensagem, o Apidog fornece três modos de visualização para ajudar você a visualizar os dados. Você pode alternar entre eles usando as abas na parte superior da área de resposta:Content: A visualização padrão. Exibe a saída de texto limpa. O Apidog analisa a mensagem JSON-RPC e extrai apenas o conteúdo principal retornado pela ferramenta (por exemplo, o campo text), removendo detalhes do protocolo para facilitar a leitura.
Preview: Renderiza conteúdo avançado retornado pela ferramenta. Se a resposta contiver Markdown, imagens ou outros recursos multimídia, esta aba os renderizará automaticamente em um formato visual (por exemplo, texto formatado, gráficos ou imagens Base64 decodificadas). Isso elimina a necessidade de decodificação manual ou análise de texto bruto.
Raw: Exibe a mensagem completa de interação JSON-RPC, incluindo todos os detalhes do protocolo (como a estrutura de jsonrpc, id e result). Use este modo ao depurar servidores MCP para verificar a conformidade com o protocolo.
Notifications#
Uma Notification representa uma mensagem unidirecional do servidor MCP (por exemplo, logs, atualizações de progresso ou alterações de recursos) que não exige uma resposta.As notificações são listadas separadamente na linha do tempo de respostas.
Elas normalmente exibem níveis de log (por exemplo, info, debug, error) e o texto da mensagem correspondente.
Suporte a variáveis#
Variáveis {{variable_name}} são compatíveis nos seguintes locais:Endereço ou comando do servidor
Valores de variáveis de ambiente
Informações de autenticação
Salvar e compartilhar#
Clientes MCP configurados podem ser salvos no projeto para uso posterior e colaboração em equipe.Observação: A árvore de diretórios MCP (lista de Tools, Prompts e Resources) é armazenada apenas localmente e é atualizada automaticamente a cada conexão.
Perguntas frequentes#
Certifique-se de que o runtime necessário (como Node.js) esteja instalado e verifique se o caminho do comando está correto.A conexão HTTP retorna erro 401#
O Apidog tentará recuperar automaticamente a configuração OAuth 2.0. Se isso falhar, configure manualmente as informações de autenticação na aba Auth.Conexão bem-sucedida, mas a árvore de diretórios está vazia#
Verifique se a configuração do servidor está correta e veja a aba Notifications para confirmar se o servidor retornou a lista de ferramentas.Incompatibilidade de tipo de parâmetro#
Ao usar o modo de formulário, o Apidog validará automaticamente os tipos de parâmetros. No modo de editor JSON, tome cuidado para não adicionar aspas em torno de números e use true/false para valores booleanos.