Visão geral#
O MCP (Model Context Protocol) é um protocolo aberto para estabelecer comunicação normalizada entre aplicações de modelos de linguagem de grande dimensão (LLM) e fontes de dados e ferramentas externas. O Apidog tem um Cliente MCP integrado que suporta a depuração e o teste de Servidores MCP.Os Servidores MCP fornecem três funcionalidades principais, todas suportadas para depuração pelo Cliente MCP do Apidog:Ferramentas: Funções executáveis do lado do servidor
Prompts: Modelos de prompt predefinidos
Recursos: Recursos de dados fornecidos pelo servidor
STDIO: Comunicação através de entrada/saída padrão, adequada para processos locais
HTTP: Comunicação através de HTTP transmissível, adequada para servidores remotos
Utilize a versão Web ou transfira a versão mais recente da aplicação de ambiente de trabalho a partir da página inicial.
Criar Cliente MCP#
Crie um novo endpoint num projeto HTTP e selecione MCP.
Ligar ao Servidor MCP#
Introduzir endereço do servidor#
O Apidog suporta várias formas de introduzir informações de ligação ao Servidor MCP:Introdução direta de comando ou URLAo colar um comando de terminal, o protocolo muda automaticamente para STDIO:Ao colar um 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 ligação#
Clique no botão Ligar para iniciar a ligação.Uma vez que é necessária a execução de comandos locais, o Apidog irá apresentar uma caixa de diálogo de confirmação de segurança. Após a confirmação, irá iniciar o processo local e estabelecer a ligação.Envie um pedido de ligação diretamente para o URL especificado.Para Servidores MCP com autenticação OAuth 2.0, o Apidog irá obter automaticamente a configuração de autenticação e apresentar a janela de autenticação
Outros métodos de autenticação (API Key, Bearer Token, Basic Auth, etc.) também podem ser configurados manualmente no separador Auth
Funcionalidades de depuração#
Ferramentas#
As ferramentas são funções executáveis fornecidas pelo servidor. Depois de selecionar uma Ferramenta, pode configurar parâmetros através do formulário ou do editor JSON.Depois de configurar os parâmetros, clique em Executar para executar. Os resultados serão apresentados na área de resposta.Prompts#
Os prompts são modelos de prompt predefinidos. Depois de selecionar um Prompt, configure os parâmetros (se existirem) e clique em Executar para obter o prompt gerado.Recursos#
Os recursos são recursos de dados fornecidos pelo servidor. Depois de selecionar um Recurso, clique em Executar para obter o conteúdo do recurso.
Opções de configuração#
Ambiente#
Disponível apenas para o modo STDIO. Utilizado 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 apenas para o modo HTTP. Suporta vários métodos de autenticação:Para Servidores MCP que suportam OAuth 2.0, o Apidog pode obter e preencher automaticamente a configuração de autenticação.Cabeçalhos#
Disponível apenas para o modo HTTP. Utilizado para configurar cabeçalhos de pedido HTTP personalizados.
Ver resposta#
Depois de clicar em Executar, os resultados da execução da ferramenta serão apresentados no painel Resposta. O Apidog categoriza a interação em dois tipos: Mensagens e Notificações.Mensagens#
Uma Mensagem representa uma interação padrão de pedido-resposta (por exemplo, executar uma ferramenta e receber um resultado).Para cada mensagem, o Apidog fornece três modos de visualização para o ajudar a visualizar os dados. Pode alternar entre eles utilizando os separadores na parte superior da área de resposta:Conteúdo: A vista predefinida. Apresenta a saída de texto limpa. O Apidog analisa a mensagem JSON-RPC e extrai apenas o conteúdo principal devolvido pela ferramenta (por exemplo, o campo text), removendo os detalhes do protocolo para facilitar a leitura.
Pré-visualização: Renderiza conteúdo avançado devolvido pela ferramenta. Se a resposta contiver Markdown, imagens ou outros recursos multimédia, este separador renderiza-os automaticamente num formato visual (por exemplo, texto formatado, gráficos ou imagens Base64 descodificadas). Isto elimina a necessidade de descodificação manual ou análise de texto bruto.
Bruto: Apresenta a mensagem completa de interação JSON-RPC, incluindo todos os detalhes do protocolo (como a estrutura jsonrpc, id e result). Utilize este modo ao depurar servidores MCP para verificar a conformidade com o protocolo.
Notificações#
Uma Notificação representa uma mensagem unidirecional do servidor MCP (por exemplo, registos, atualizações de progresso ou alterações de recursos) que não requer uma resposta.As notificações são listadas separadamente na linha temporal da resposta.
Normalmente, apresentam níveis de registo (por exemplo, info, debug, error) e o texto da mensagem correspondente.
Suporte de variáveis#
As variáveis {{variable_name}} são suportadas nas seguintes localizações:Endereço ou comando do servidor
Valores de variáveis de ambiente
Informações de autenticação
Guardar e partilhar#
Os clientes MCP configurados podem ser guardados no projeto para utilização posterior e colaboração em equipa.Nota: A árvore de diretórios MCP (lista de Ferramentas, Prompts e Recursos) é armazenada apenas localmente e é atualizada automaticamente em cada ligação.
FAQ#
Certifique-se de que o runtime necessário (como Node.js) está instalado e verifique se o caminho do comando está correto.A ligação HTTP devolve o erro 401#
O Apidog tentará obter automaticamente a configuração OAuth 2.0. Se falhar, configure manualmente as informações de autenticação no separador Auth.Ligação bem-sucedida, mas a árvore de diretórios está vazia#
Verifique se a configuração do servidor está correta e consulte o separador Notificações para confirmar se o servidor devolveu a lista de ferramentas.Incompatibilidade do tipo de parâmetro#
Ao utilizar o modo de formulário, o Apidog irá validar automaticamente os tipos de parâmetros. No modo de editor JSON, tenha cuidado para não adicionar aspas em torno de números e utilize true/false para valores booleanos.