# 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

{% hint style="info" %}
**URL MCP :** `https://api.abby.fr/mcp`\
**Transport :** StreamableHTTP
{% endhint %}

## 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>`

{% hint style="warning" %}
Le flux OAuth est géré automatiquement par les clients compatibles (Claude Desktop, Cursor, etc.). Vous n'avez pas à implémenter le flux manuellement.
{% endhint %}

## Configuration dans Claude Desktop

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

```json
{
  "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](/mcp/facturation.md)                 | 19     | Factures, devis, acomptes, avoirs, statistiques |
| [Catalogue](/mcp/catalogue.md)                     | 5      | Produits et services                            |
| [Clients](/mcp/clients.md)                         | 15     | Contacts et organisations                       |
| [Déclarations URSSAF](/mcp/declarations-urssaf.md) | 2      | Estimation CA et déclaration                    |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.abby.fr/mcp/demarrer.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.