Démarrer avec le MCP

Qu'est-ce que le MCP ?

Le Model Context Protocol (MCP) est un protocole ouvert qui permet aux assistants IA d'interagir directement avec des outils et services externes. Grâce au serveur MCP d'Abby, vous pouvez piloter votre gestion (facturation, clients, catalogue, déclarations URSSAF) depuis n'importe quel client IA compatible.

Clients compatibles

Le serveur MCP d'Abby est compatible avec tout client supportant le transport StreamableHTTP :

• Claude Desktop (Anthropic)

• Cursor

• Tout client compatible MCP

URL du serveur

URL MCP : https://api.abby.fr/mcp Transport : StreamableHTTP

Authentification

Le serveur MCP d'Abby utilise OAuth 2.0 pour authentifier les requêtes. Le flux est le suivant :

1. Le client MCP envoie une première requête au serveur

2. Le serveur répond avec un code 401 et un header WWW-Authenticate contenant l'URL d'autorisation

3. Le client redirige l'utilisateur vers la page d'autorisation Abby

4. L'utilisateur autorise l'accès à son compte Abby

5. Le client reçoit un token d'accès (Bearer token)

6. Toutes les requêtes suivantes incluent le header Authorization: Bearer <token>

Le flux OAuth est géré automatiquement par les clients compatibles (Claude Desktop, Cursor, etc.). Vous n'avez pas à implémenter le flux manuellement.

Configuration dans Claude Desktop

Ajoutez la configuration suivante dans votre fichier de configuration Claude Desktop :

{
  "mcpServers": {
    "abby": {
      "url": "https://api.abby.fr/mcp"
    }
  }
}

Claude Desktop détectera automatiquement le flux OAuth et vous guidera dans l'autorisation.

Configuration dans Cursor

Dans les paramètres de Cursor, ajoutez un nouveau serveur MCP :

• Nom : Abby

• Type : StreamableHTTP

• URL : https://api.abby.fr/mcp

Outils disponibles

Une fois connecté, vous avez accès à 40 outils répartis en 4 domaines :

Domaine	Outils	Description
Facturation	19	Factures, devis, acomptes, avoirs, statistiques
Catalogue	5	Produits et services
Clients	15	Contacts et organisations
Déclarations URSSAF	2	Estimation CA et déclaration