Servidores MCP con tecnología ACI.dev

Para obtener documentación completa y tutoriales sobre servidores MCP, visita aci.dev docs .

Tabla de contenido

• Servidores MCP con tecnología ACI.dev
  • Tabla de contenido
  • Descripción general
  • Prerrequisitos
  • Instalación
  • Uso
    • Servidor de aplicaciones
    • Servidor unificado
  • Comprensión de los dos tipos de servidores
    • Servidor de aplicaciones
    • Servidor unificado
  • Configuración
  • Preguntas frecuentes
  • Depuración

Descripción general

Para obtener documentación completa y tutoriales sobre servidores MCP, visita aci.dev docs .

Este paquete proporciona dos servidores de Protocolo de contexto de modelo (MCP) para acceder a las funciones administradas (herramientas) de ACI.dev :

• aci-mcp-apps : un servidor MCP que proporciona acceso directo a funciones (herramientas) desde aplicaciones específicas
• aci-mcp-unified : un servidor MCP que proporciona dos metafunciones (herramientas) ( ACI_SEARCH_FUNCTIONS y ACI_EXECUTE_FUNCTION ) para descubrir y ejecutar TODAS las funciones (herramientas) disponibles en ACI.dev

Prerrequisitos

Antes de utilizar este paquete, necesita (para obtener más información, consulte el tutorial ):

1. Establezca la variable de entorno ACI_API_KEY con su clave API ACI.dev
2. Configure aplicaciones y configúrelas en allowed_apps para su agente en platform.aci.dev .
3. Vincula las cuentas específicas de tu aplicación bajo el mismo --linked-account-owner-id que proporcionarás más adelante para iniciar los servidores MCP

Instalación

El paquete se publica en PyPI, por lo que puedes ejecutarlo directamente usando uvx :

Uso

Servidor de aplicaciones

El servidor de aplicaciones proporciona acceso directo a las funciones (herramientas) de aplicaciones específicas. Puede especificar una o más aplicaciones con el parámetro --apps . (Para ver la lista de aplicaciones disponibles, visite ACI.dev ).

Servidor unificado

El servidor unificado proporciona dos metafunciones (herramientas) para descubrir y ejecutar CUALQUIER función (herramienta) disponible en ACI.dev , incluso si no están enumeradas directamente en el servidor.

Las funciones (herramientas) se buscan y ejecutan dinámicamente según sus necesidades. No tendrá que preocuparse por tener miles de herramientas ocupando la ventana contextual de su LLM ni por tener que integrar varios servidores MCP.

Comprensión de los dos tipos de servidores

Para obtener documentación completa y tutoriales sobre servidores MCP, visita aci.dev docs .

Servidor de aplicaciones

El servidor de aplicaciones proporciona acceso directo a funciones/herramientas específicas de la aplicación que especifique con el parámetro --apps . Estas herramientas aparecerán directamente en la lista de herramientas cuando los clientes MCP (p. ej., Claude Desktop, Cursor, etc.) interactúen con este servidor.

Servidor unificado

El servidor unificado no expone directamente herramientas específicas de la aplicación. En su lugar, proporciona dos metafunciones (herramientas):

1. ACI_SEARCH_FUNCTIONS : descubre funciones (herramientas) según su intención/necesidades
2. ACI_EXECUTE_FUNCTION : ejecuta CUALQUIER función (herramienta) descubierta por la búsqueda

Este enfoque permite a los clientes de MCP descubrir y usar dinámicamente cualquier función disponible en la plataforma ACI.dev sin necesidad de listarlas todas previamente. Puede buscar la herramienta adecuada según sus necesidades y ejecutarla.

Configuración (integración con clientes MCP)

Consulte las secciones Servidor MCP unificado y Servidor MCP de aplicaciones para obtener más información sobre cómo configurar los servidores MCP con diferentes clientes MCP.

Preguntas frecuentes

• ¿Cómo obtengo la ACI_API_KEY ?ACI_API_KEY es la clave API de tu proyecto ACI.dev . Puedes encontrarla en la configuración del proyecto ACI.dev .
• ¿Cómo configurar Apps y permitir el acceso a ellas?Puede configurar aplicaciones y permitir el acceso a ellas en la configuración del proyecto ACI.dev .
• ¿Cómo obtengo el LINKED_ACCOUNT_OWNER_ID ?LINKED_ACCOUNT_OWNER_ID es el ID de la cuenta que desea usar para acceder a las funciones. Puede encontrarlo en la configuración del proyecto ACI.dev .
• ¿Cuál es el beneficio de utilizar el servidor unificado en lugar del servidor de aplicaciones?La mayoría de los servidores MCP actuales se limitan a un conjunto específico de funciones (herramientas), generalmente de una sola aplicación. Si necesita usar funciones de varias aplicaciones, deberá integrar varios servidores MCP. Sin embargo, incluso si acepta la sobrecarga de gestión que supone integrar varios servidores MCP, el rendimiento de las llamadas a herramientas LLM podría verse afectado, ya que todas las herramientas se cargan simultáneamente en la ventana de contexto de LLM.Y muchas veces no sabes de antemano qué aplicaciones/funciones (herramientas) necesitas.Sin embargo, el servidor unificado le permite descubrir y ejecutar CUALQUIER función disponible en ACI.dev de forma dinámica sin preocuparse por tener miles de herramientas ocupando la ventana de contexto de su LLM o tener que integrar múltiples servidores MCP.
• ¿Cuál es el beneficio de utilizar el servidor de aplicaciones en lugar del servidor unificado?En algunos casos, el rendimiento de la llamada de función es más confiable porque las funciones están planificadas previamente y son limitadas.
• ¿Cómo especificar una lista de aplicaciones para usar con el servidor de aplicaciones?Puedes especificar una lista de aplicaciones separadas por comas para usar con el servidor de aplicaciones mediante el parámetro --apps . Intenta evitar espacios entre los nombres de las aplicaciones.
• ¿Puedo usar funciones (herramientas) solo de una aplicación?Sí, puedes usar funciones (herramientas) de una aplicación especificando el nombre de la (única) aplicación con el parámetro --apps .

Depuración

Puede utilizar el inspector MCP para depurar el servidor:

Ejecutar tail -n 20 -f ~/Library/Logs/Claude/mcp*.log mostrará los registros del servidor y puede ayudarlo a depurar cualquier problema.