Comment utiliser les serveurs MCP ACI.dev

Dans le paysage de développement en évolution rapide d'aujourd'hui, les serveurs Model Context Protocol (MCP) sont apparus comme des outils puissants qui relient les assistants d'IA aux sources de données spécialisées. ACI.dev MCP Servers se distinguent en offrant une solution complète qui permet d'accéder à plusieurs fonctions d'application via une interface unifiée.

ACI.dev propose deux types distincts de serveurs MCP, chacun étant conçu pour répondre à différents besoins de développement :

Apps MCP Server : Ce serveur permet d'accéder directement aux fonctions des applications spécifiques que vous sélectionnez. Contrairement à la plupart des serveurs MCP qui vous limitent à une seule application, le serveur Apps d'ACI.dev vous permet d'inclure plusieurs applications dans une seule configuration de serveur.

Unified MCP Server : Ce serveur innovant adopte une approche différente en fournissant deux méta-fonctions qui peuvent découvrir et exécuter n'importe quelle fonction disponible sur la plateforme ACI.dev. Cette approche dynamique élimine le besoin de répertorier tous les outils à l'avance.

La puissance des serveurs ACI.dev MCP réside dans leur capacité à :

Accéder à plusieurs fonctions d'application sans basculer entre différents serveurs MCP
Découvrir des outils pertinents de manière dynamique en fonction de vos besoins spécifiques
Exécuter des fonctions sur différentes applications de manière transparente
Réduire l'utilisation de la fenêtre contextuelle en ne chargeant que les outils pertinents en cas de besoin

Pour les développeurs d'API, ces capacités se traduisent par un flux de travail plus rationalisé où les assistants d'IA peuvent accéder et utiliser des outils de diverses applications sans la surcharge de la gestion de plusieurs connexions distinctes.

💡

Conseil de pro : Bien que les serveurs ACI.dev MCP offrent un excellent accès aux fonctions multi-applications, Apidog MCP Server offre des capacités spécialisées pour le développement d'API. Apidog MCP Server donne aux assistants d'IA un accès direct à vos spécifications d'API, garantissant que le code généré correspond parfaitement à vos documents de conception.

button

Configuration des serveurs ACI.dev MCP : un guide étape par étape

Démarrer avec les serveurs ACI.dev MCP nécessite quelques étapes simples. Cette section décrit le processus de configuration complet pour les deux types de serveurs.

Conditions préalables pour les serveurs ACI.dev MCP

Avant de commencer le processus de configuration, assurez-vous d'avoir :

Une clé API ACI.dev (obtenable à partir de la plateforme de développement ACI)
Le gestionnaire de paquets UV installé
Des applications configurées et définies dans allowed_apps pour votre agent sur platform.aci.dev
Lié vos comptes spécifiques à l'application sous le même linked-account-owner-id
Un IDE qui prend en charge MCP, tel que :

Claude Desktop
Cursor
VS Code avec les extensions appropriées

Installation du gestionnaire de paquets UV

Tout d'abord, installez le gestionnaire de paquets UV si vous ne l'avez pas déjà fait :

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

Configuration du serveur Apps MCP

Le serveur Apps MCP permet d'accéder directement aux fonctions des applications spécifiques que vous sélectionnez :

Choisissez vos applications

Identifiez les applications auxquelles vous souhaitez accéder. Vous pouvez trouver les applications disponibles sur platform.aci.dev/apps.

Exécuter le serveur

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

Remplacez <LINKED_ACCOUNT_OWNER_ID> par votre ID de compte à partir de platform.aci.dev.

Configurez votre IDE

Pour Claude Desktop, ajoutez ceci à votre 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>"]
   }
 }
}

Pour Cursor, ajoutez à votre 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>"
     }
   }
 }
}

Configuration du serveur MCP unifié

Le serveur MCP unifié fournit une approche plus dynamique avec deux méta-fonctions :

ACI_SEARCH_FUNCTIONS_WITH_INTENT - Découvre les fonctions en fonction de votre intention/besoins
ACI_EXECUTE_FUNCTION - Exécute toute fonction découverte par la recherche

Exécuter le serveur

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

Configurez votre IDE

Pour Claude Desktop, ajoutez ceci à votre claude_desktop_config.json :

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

Pour Cursor, ajoutez à votre 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>"
     }
   }
 }
}

Vérification de votre configuration

Pour vérifier que votre configuration fonctionne correctement :

Pour le serveur Apps : Demandez à votre assistant d'IA d'utiliser une fonction de l'une de vos applications spécifiées :

"Rechercher des nouvelles récentes sur le développement d'API en utilisant Brave Search"

Pour le serveur unifié : Demandez à votre assistant d'IA de découvrir et d'utiliser une fonction :

"J'ai besoin de trouver des informations sur les meilleures pratiques en matière d'API REST"

L'IA doit répondre en utilisant directement la fonction spécifiée (serveur Apps) ou en découvrant d'abord, puis en exécutant la fonction appropriée (serveur unifié).

Utiliser Apidog MCP Server pour le développement d'API

Alors que les serveurs ACI.dev MCP excellent à fournir un accès à plusieurs fonctions d'application, le développement d'API nécessite souvent des outils spécialement conçus pour travailler avec les spécifications et les implémentations d'API. C'est là qu' Apidog MCP Server entre en jeu, offrant des capacités spécialement conçues pour les flux de travail de développement axés sur les API qui complètent les fonctionnalités générales des serveurs ACI.dev.

Améliorer le développement d'API avec Apidog MCP Server

Apidog MCP Server représente une avancée significative dans la méthodologie de développement d'API, en se concentrant spécifiquement sur la mise à disposition des spécifications d'API directement aux assistants d'IA. Contrairement aux serveurs MCP à usage général, Apidog MCP Server est spécialement conçu pour le développement d'API, garantissant un alignement parfait entre les spécifications et les implémentations.

Comment fonctionne Apidog MCP Server

Une fois configuré, Apidog MCP Server lit et met automatiquement en cache les données de spécification d'API sur votre machine locale. Cela permet aux assistants d'IA de récupérer et d'utiliser ces données de manière transparente pendant le développement. Le processus fonctionne comme suit :

Connexion aux spécifications d'API : Apidog MCP Server se connecte directement à vos spécifications d'API, qu'elles se trouvent dans les projets Apidog, la documentation publiée ou les fichiers OpenAPI
Mise en cache des données localement : Les spécifications sont mises en cache pour un accès rapide
Fournir un contexte à l'IA : Lorsque vous interrogez l'IA sur votre API, elle peut accéder aux spécifications exactes
Activation de la génération de code : L'IA peut générer du code qui correspond parfaitement à la conception de votre API

Cette approche spécialisée garantit que tout le développement assisté par l'IA reste parfaitement aligné sur vos spécifications d'API, éliminant la déconnexion courante entre la conception et l'implémentation.

Configuration d'Apidog MCP Server

La configuration d'Apidog MCP Server nécessite quelques étapes simples :

Conditions préalables :

Node.js (version 18 ou supérieure)
Un IDE qui prend en charge MCP (Cursor, VS Code + plugin Cline)

Choisissez votre source de données : Apidog MCP Server prend en charge trois sources de données différentes :

Projet Apidog : Pour accéder aux spécifications d'API au sein de votre équipe
Documentation d'API en ligne : Pour lire la documentation d'API publiée via Apidog
Fichiers OpenAPI : Pour travailler avec des fichiers Swagger/OpenAPI locaux ou en ligne

Configurez MCP dans votre IDE : Pour le projet Apidog comme source de données (exemple Windows) :

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

Vérifier la configuration : Testez en demandant à votre assistant d'IA :

"Veuillez récupérer la spécification de l'API via MCP et me dire combien de points de terminaison existent dans le projet"

Flux de travail de développement d'API puissants avec Apidog MCP

Apidog MCP Server permet des flux de travail spécialisés qui transforment le développement d'API :

Génération de code basée sur les spécifications

"Utilisez MCP pour récupérer la spécification de l'API et générer des enregistrements Java pour le schéma 'Product' et les schémas associés"

Mise à jour des implémentations lorsque les spécifications changent

"En fonction de la spécification de l'API, ajoutez les nouveaux champs au DTO 'Product'"

Ajout de documentation au code

"Ajoutez des commentaires pour chaque champ de la classe 'Product' en fonction de la spécification de l'API"

Création d'implémentations d'API complètes

"Générez tout le code MVC lié au point de terminaison '/users' en fonction de la spécification de l'API"

Conclusion : choisir le bon serveur MCP pour vos besoins de développement

L'émergence de serveurs MCP spécialisés marque une avancée significative dans le développement assisté par l'IA. Les serveurs ACI.dev MCP excellent à fournir un accès aux fonctions multi-applications, tandis qu'Apidog MCP Server se concentre spécifiquement sur le développement d'API en garantissant un alignement parfait entre les spécifications et les implémentations.

Pour les développeurs, ces outils servent des objectifs complémentaires :

Serveurs ACI.dev MCP : Idéal lorsque vous devez accéder aux fonctions de plusieurs applications ou que vous souhaitez une découverte dynamique des fonctions en fonction de vos besoins spécifiques.
Apidog MCP Server : Parfait lors de l'implémentation d'API et en garantissant que le code s'aligne parfaitement sur les spécifications d'API.

En intégrant ces outils spécialisés dans votre flux de travail en fonction de vos exigences spécifiques, vous pouvez améliorer considérablement la productivité et la qualité du code. Ces serveurs MCP représentent un changement fondamental dans les pratiques de développement, rendant le travail plus efficace, précis et, en fin de compte, plus agréable.