Cómo usar los servidores MCP de ACI.dev

En el panorama de desarrollo actual, que evoluciona rápidamente, los servidores del Protocolo de Contexto del Modelo (MCP) han surgido como herramientas potentes que conectan a los asistentes de IA con fuentes de datos especializadas. Los Servidores MCP de ACI.dev destacan por ofrecer una solución integral que proporciona acceso a múltiples funciones de aplicaciones a través de una interfaz unificada.

ACI.dev proporciona dos tipos distintos de servidores MCP, cada uno diseñado para abordar diferentes necesidades de desarrollo:

Servidor MCP de Aplicaciones: Este servidor proporciona acceso directo a las funciones de aplicaciones específicas que seleccione. A diferencia de la mayoría de los servidores MCP que lo limitan a una sola aplicación, el Servidor de Aplicaciones de ACI.dev le permite incluir varias aplicaciones en una sola configuración de servidor.

Servidor MCP Unificado: Este innovador servidor adopta un enfoque diferente al proporcionar dos meta funciones que pueden descubrir y ejecutar cualquier función disponible en la plataforma ACI.dev. Este enfoque dinámico elimina la necesidad de enumerar todas las herramientas por adelantado.

El poder de los Servidores MCP de ACI.dev reside en su capacidad para:

Acceder a múltiples funciones de aplicaciones sin cambiar entre diferentes servidores MCP
Descubrir herramientas relevantes dinámicamente en función de sus necesidades específicas
Ejecutar funciones en diferentes aplicaciones sin problemas
Reducir el uso de la ventana de contexto cargando solo las herramientas relevantes cuando sea necesario

Para los desarrolladores de API, estas capacidades se traducen en un flujo de trabajo más ágil donde los asistentes de IA pueden acceder y utilizar herramientas de varias aplicaciones sin la sobrecarga de administrar múltiples conexiones separadas.

💡

Consejo profesional: Si bien los Servidores MCP de ACI.dev ofrecen un excelente acceso a funciones de múltiples aplicaciones, el Servidor MCP de Apidog proporciona capacidades especializadas para el desarrollo de API. El Servidor MCP de Apidog brinda a los asistentes de IA acceso directo a sus especificaciones de API, lo que garantiza que el código generado coincida perfectamente con sus documentos de diseño.

button

Configuración de los Servidores MCP de ACI.dev: Una guía paso a paso

Comenzar con los Servidores MCP de ACI.dev requiere algunos pasos sencillos. Esta sección explica el proceso de configuración completo para ambos tipos de servidores.

Requisitos previos para los Servidores MCP de ACI.dev

Antes de comenzar el proceso de configuración, asegúrese de tener:

Una clave de API de ACI.dev (que se puede obtener en la plataforma de desarrollo de ACI)
El administrador de paquetes UV instalado
Aplicaciones configuradas y establecidas en allowed_apps para su agente en platform.aci.dev
Vinculadas sus cuentas específicas de la aplicación bajo el mismo linked-account-owner-id
Un IDE que admita MCP, como:

Claude Desktop
Cursor
VS Code con las extensiones apropiadas

Instalación del administrador de paquetes UV

Primero, instale el administrador de paquetes UV si aún no lo ha hecho:

curl -sSf https://install.pypa.io/get-pip.py | python3 -
pip install uv

Configuración del Servidor MCP de Aplicaciones

El Servidor MCP de Aplicaciones proporciona acceso directo a las funciones de aplicaciones específicas que seleccione:

Elija sus aplicaciones

Identifique a qué aplicaciones desea acceder. Puede encontrar las aplicaciones disponibles en platform.aci.dev/apps.

Ejecute el servidor

uvx aipolabs-mcp apps-server --apps "BRAVE_SEARCH,GMAIL" --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID>

Reemplace <LINKED_ACCOUNT_OWNER_ID> con su ID de cuenta de platform.aci.dev.

Configure su IDE

Para Claude Desktop, agregue esto a su claude_desktop_config.json:

{
 "mcpServers": {
   "aipolabs-mcp-apps": {
     "command": "uvx",
     "args": ["aipolabs-mcp", "apps-server", "--apps", "BRAVE_SEARCH,GMAIL", "--linked-account-owner-id", "<LINKED_ACCOUNT_OWNER_ID>"]
   }
 }
}

Para Cursor, agregue a su mcp.json:

{
 "mcpServers": {
   "aipolabs-mcp-apps": {
     "command": "uvx",
     "args": ["aipolabs-mcp", "apps-server", "--apps", "BRAVE_SEARCH,GMAIL", "--linked-account-owner-id", "<LINKED_ACCOUNT_OWNER_ID>"],
     "env": {
       "AIPOLABS_ACI_API_KEY": "<AIPOLABS_ACI_API_KEY>"
     }
   }
 }
}

Configuración del Servidor MCP Unificado

El Servidor MCP Unificado proporciona un enfoque más dinámico con dos meta funciones:

ACI_SEARCH_FUNCTIONS_WITH_INTENT: descubre funciones basadas en su intención/necesidades
ACI_EXECUTE_FUNCTION: ejecuta cualquier función descubierta por la búsqueda

Ejecute el servidor

uvx aipolabs-mcp unified-server --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID>

Configure su IDE

Para Claude Desktop, agregue esto a su claude_desktop_config.json:

{
 "mcpServers": {
   "aipolabs-mcp-unified": {
     "command": "uvx",
     "args": ["aipolabs-mcp", "unified-server", "--linked-account-owner-id", "<LINKED_ACCOUNT_OWNER_ID>"]
   }
 }
}

Para Cursor, agregue a su mcp.json:

{
 "mcpServers": {
   "aipolabs-mcp-unified": {
     "command": "uvx",
     "args": ["aipolabs-mcp", "unified-server", "--linked-account-owner-id", "<LINKED_ACCOUNT_OWNER_ID>"],
     "env": {
       "AIPOLABS_ACI_API_KEY": "<AIPOLABS_ACI_API_KEY>"
     }
   }
 }
}

Verificación de su configuración

Para verificar que su configuración funciona correctamente:

Para el Servidor de Aplicaciones: pídale a su asistente de IA que use una función de una de sus aplicaciones especificadas:

"Buscar noticias recientes sobre el desarrollo de API utilizando Brave Search"

Para el Servidor Unificado: pídale a su asistente de IA que descubra y use una función:

"Necesito encontrar información sobre las mejores prácticas de la API REST"

La IA debe responder ya sea utilizando directamente la función especificada (Servidor de Aplicaciones) o primero descubriendo y luego ejecutando la función apropiada (Servidor Unificado).

Use el Servidor MCP de Apidog para el desarrollo de API

Si bien los Servidores MCP de ACI.dev sobresalen al proporcionar acceso a múltiples funciones de aplicaciones, el desarrollo de API a menudo requiere herramientas diseñadas específicamente para trabajar con especificaciones e implementaciones de API. Aquí es donde el Servidor MCP de Apidog entra en foco, ofreciendo capacidades creadas a propósito para flujos de trabajo de desarrollo basados en API que complementan la funcionalidad de propósito general de los servidores de ACI.dev.

Mejora del desarrollo de API con el Servidor MCP de Apidog

El Servidor MCP de Apidog representa un avance significativo en la metodología de desarrollo de API, centrándose específicamente en hacer que las especificaciones de API sean directamente accesibles para los asistentes de IA. A diferencia de los servidores MCP de propósito general, el Servidor MCP de Apidog está diseñado específicamente para el desarrollo de API, lo que garantiza una alineación perfecta entre las especificaciones y las implementaciones.

Cómo funciona el Servidor MCP de Apidog

Una vez configurado, el Servidor MCP de Apidog lee y almacena automáticamente en caché los datos de especificación de la API en su máquina local. Esto permite a los asistentes de IA recuperar y utilizar estos datos sin problemas durante el desarrollo. El proceso funciona mediante:

Conexión a las especificaciones de la API: el Servidor MCP de Apidog se vincula directamente a sus especificaciones de API, ya sea que estén en proyectos de Apidog, documentación publicada o archivos OpenAPI
Almacenamiento en caché de datos localmente: las especificaciones se almacenan en caché para un acceso rápido
Proporcionar contexto a la IA: cuando le pregunta a la IA sobre su API, puede acceder a las especificaciones exactas
Habilitación de la generación de código: la IA puede generar código que coincida perfectamente con el diseño de su API

Este enfoque especializado garantiza que todo el desarrollo asistido por IA permanezca perfectamente alineado con sus especificaciones de API, eliminando la desconexión común entre el diseño y la implementación.

Configuración del Servidor MCP de Apidog

La configuración del Servidor MCP de Apidog requiere algunos pasos simples:

Requisitos previos:

Node.js (versión 18 o superior)
Un IDE que admita MCP (Cursor, VS Code + complemento Cline)

Elija su fuente de datos: el Servidor MCP de Apidog admite tres fuentes de datos diferentes:

Proyecto Apidog: para acceder a las especificaciones de la API dentro de su equipo
Documentación de la API en línea: para leer la documentación de la API publicada a través de Apidog
Archivos OpenAPI: para trabajar con archivos Swagger/OpenAPI locales o en línea

Configure MCP en su IDE: para el Proyecto Apidog como fuente de datos (ejemplo de Windows):

{
 "mcpServers": {
   "API specification": {
     "command": "cmd",
     "args": [
       "/c",
       "npx",
       "-y",
       "apidog-mcp-server@latest",
       "--project=<project-id>"
     ],
     "env": {
       "APIDOG_ACCESS_TOKEN": "<access-token>"
     }
   }
 }
}

Verificar configuración: pruebe preguntándole a su asistente de IA:

"Por favor, obtenga la especificación de la API a través de MCP y dígame cuántos puntos finales existen en el proyecto"

Flujos de trabajo potentes de desarrollo de API con Apidog MCP

El Servidor MCP de Apidog permite flujos de trabajo especializados que transforman el desarrollo de API:

Generación de código basada en especificaciones

"Use MCP para obtener la especificación de la API y generar registros de Java para el esquema 'Product' y los esquemas relacionados"

Actualización de implementaciones cuando cambian las especificaciones

"Según la especificación de la API, agregue los nuevos campos al DTO 'Product'"

Adición de documentación al código

"Agregue comentarios para cada campo en la clase 'Product' según la especificación de la API"

Creación de implementaciones completas de API

"Genere todo el código MVC relacionado con el punto final '/users' de acuerdo con la especificación de la API"

Conclusión: Elegir el servidor MCP adecuado para sus necesidades de desarrollo

La aparición de servidores MCP especializados marca un avance significativo en el desarrollo asistido por IA. Los Servidores MCP de ACI.dev sobresalen al proporcionar acceso a funciones de múltiples aplicaciones, mientras que el Servidor MCP de Apidog se centra específicamente en el desarrollo de API al garantizar una alineación perfecta entre las especificaciones y las implementaciones.

Para los desarrolladores, estas herramientas tienen propósitos complementarios:

Servidores MCP de ACI.dev: ideales cuando necesita acceder a funciones de múltiples aplicaciones o desea un descubrimiento dinámico de funciones basado en sus necesidades específicas.
Servidor MCP de Apidog: perfecto al implementar API y garantizar que el código se alinee perfectamente con las especificaciones de la API.

Al incorporar estas herramientas especializadas en su flujo de trabajo en función de sus requisitos específicos, puede mejorar significativamente la productividad y la calidad del código. Estos servidores MCP representan un cambio fundamental en las prácticas de desarrollo, haciendo que el trabajo sea más eficiente, preciso y, en última instancia, más agradable.