Descripción general#
MCP (Model Context Protocol) es un protocolo abierto para establecer una comunicación estandarizada entre aplicaciones de modelos de lenguaje grandes (LLM) y fuentes de datos y herramientas externas. Apidog cuenta con un MCP Client integrado que permite depurar y probar MCP Servers.Los MCP Servers proporcionan tres funciones principales, todas compatibles con la depuración mediante el Apidog MCP Client:Tools: Funciones ejecutables del lado del servidor
Prompts: Plantillas de prompts predefinidas
Resources: Recursos de datos proporcionados por el servidor
STDIO: Comunicación mediante entrada/salida estándar, adecuada para procesos locales
HTTP: Comunicación mediante Streamable HTTP, adecuada para servidores remotos
Utilice la versión web o descargue la versión más reciente de la aplicación de escritorio desde la página de inicio.
Crear MCP Client#
Cree un nuevo endpoint en un proyecto HTTP y seleccione MCP.
Conectarse al MCP Server#
Introducir la dirección del servidor#
Apidog admite varias formas de introducir la información de conexión del MCP Server:Entrada directa de comando o URLAl pegar un comando de terminal, el protocolo cambia automáticamente a STDIO:Al pegar una URL, el protocolo cambia automáticamente a 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"
}
Establecer conexión#
Haga clic en el botón Connect para iniciar la conexión.Dado que se requiere la ejecución de comandos locales, Apidog mostrará un cuadro de diálogo de confirmación de seguridad. Después de la confirmación, iniciará el proceso local y establecerá la conexión.Envíe una petición de conexión directamente a la URL especificada.Para MCP Servers con autenticación OAuth 2.0, Apidog recuperará automáticamente la configuración de autenticación y mostrará la ventana de autenticación
Otros métodos de autenticación (API Key, Bearer Token, Basic Auth, etc.) también se pueden configurar manualmente en la pestaña Auth
Funciones de depuración#
Las Tools son funciones ejecutables proporcionadas por el servidor. Después de seleccionar una Tool, puede configurar los parámetros mediante un formulario o un editor JSON.Después de configurar los parámetros, haga clic en Run para ejecutar. Los resultados se mostrarán en el área de respuesta.Prompts#
Los Prompts son plantillas de prompts predefinidas. Después de seleccionar un Prompt, configure los parámetros (si los hay) y haga clic en Run para obtener el prompt generado.Resources#
Los Resources son recursos de datos proporcionados por el servidor. Después de seleccionar un Resource, haga clic en Run para recuperar el contenido del recurso.
Opciones de configuración#
Entorno#
Disponible solo para el modo STDIO. Se utiliza para configurar variables de entorno al iniciar el proceso del MCP Server.| Clave | Valor |
|---|
| ACCESS_TOKEN | your-token-here |
| NODE_ENV | production |
Auth#
Disponible solo para el modo HTTP. Admite varios métodos de autenticación:Para los MCP Servers que admiten OAuth 2.0, Apidog puede recuperar y completar automáticamente la configuración de autenticación.Encabezados#
Disponible solo para el modo HTTP. Se utiliza para configurar encabezados de petición HTTP personalizados.
Ver la respuesta#
Después de hacer clic en Run, los resultados de ejecución de la herramienta se mostrarán en el panel Response. Apidog clasifica la interacción en dos tipos: Messages y Notifications.Messages#
Un Message representa una interacción estándar de petición-respuesta (por ejemplo, ejecutar una herramienta y recibir un resultado).Para cada mensaje, Apidog ofrece tres modos de visualización para ayudarle a visualizar los datos. Puede alternar entre ellos mediante las pestañas situadas en la parte superior del área de respuesta:Content: La vista predeterminada. Muestra la salida de texto limpia. Apidog analiza el mensaje JSON-RPC y extrae únicamente el contenido principal devuelto por la herramienta (por ejemplo, el campo text), eliminando los detalles del protocolo para facilitar la lectura.
Preview: Renderiza el contenido enriquecido devuelto por la herramienta. Si la respuesta contiene Markdown, imágenes u otros recursos multimedia, esta pestaña los renderiza automáticamente en un formato visual (por ejemplo, texto con formato, gráficos o imágenes Base64 decodificadas). Esto elimina la necesidad de decodificación manual o análisis de texto sin procesar.
Raw: Muestra el mensaje completo de interacción JSON-RPC, incluidos todos los detalles del protocolo (como la estructura jsonrpc, id y result). Utilice este modo al depurar servidores MCP para verificar el cumplimiento del protocolo.
Notifications#
Una Notification representa un mensaje unidireccional del MCP server (por ejemplo, registros, actualizaciones de progreso o cambios de recursos) que no requiere una respuesta.Las notificaciones se enumeran por separado en la línea de tiempo de respuestas.
Normalmente muestran niveles de registro (por ejemplo, info, debug, error) y el texto del mensaje correspondiente.
Compatibilidad con variables#
Las variables {{variable_name}} son compatibles en las siguientes ubicaciones:Dirección o comando del servidor
Valores de variables de entorno
Información de autenticación
Guardar y compartir#
Los MCP clients configurados se pueden guardar en el proyecto para su uso posterior y la colaboraci ón en equipo.Nota: El árbol de directorios MCP (lista de Tools, Prompts y Resources) se almacena solo localmente y se actualiza automáticamente en cada conexión.
Preguntas frecuentes#
La conexión STDIO falla con el error "command not found"#
Asegúrese de que el runtime requerido (como Node.js) esté instalado y compruebe que la ruta del comando sea correcta.La conexión HTTP devuelve un error 401#
Apidog intentará recuperar automáticamente la configuración de OAuth 2.0. Si falla, configure manualmente la información de autenticación en la pestaña Auth.La conexión se realiza correctamente, pero el árbol de directorios está vacío#
Compruebe que la configuración del servidor sea correcta y consulte la pestaña Notifications para confirmar si el servidor ha devuelto la lista de herramientas.Incompatibilidad de tipo de parámetro#
Al utilizar el modo formulario, Apidog validará automáticamente los tipos de parámetros. En el modo de editor JSON, tenga cuidado de no añadir comillas alrededor de los números y utilice true/false para valores booleanos.