> ## Documentation Index
> Fetch the complete documentation index at: https://docs.finkare.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Connecteur MCP pour Claude

> Pilotez votre recouvrement Finkare directement depuis Claude : consultation des dossiers, factures en retard, actions sur la cascade de relance.

## Vue d'ensemble

Finkare expose un serveur **MCP** (Model Context Protocol) qui permet de connecter votre compte Finkare a Claude (claude.ai, Claude Desktop, Claude Code). Une fois le connecteur ajoute, vous pouvez interroger vos dossiers de recouvrement et declencher des actions en langage naturel :

* « Quelles sont mes factures en retard de plus de 30 jours ? »
* « Montre-moi le contexte complet du dossier Dupont »
* « Mets en pause la relance du dossier X, le client m'a appele »
* « Signale un paiement externe de 1 250 € sur la facture FAC-2026-042 »

|                      |                                                                        |
| -------------------- | ---------------------------------------------------------------------- |
| **URL du serveur**   | `https://mcp.finkare.io/mcp`                                           |
| **Transport**        | Streamable HTTP                                                        |
| **Authentification** | OAuth 2.1 (Authorization Code + PKCE, Dynamic Client Registration)     |
| **Isolation**        | Chaque session est strictement limitee aux donnees de votre entreprise |

## Ajouter le connecteur a Claude

### Claude.ai (web)

1. Ouvrez **Settings → Connectors** (ou **Parametres → Connecteurs**).
2. Cliquez sur **Add custom connector** et renseignez l'URL : `https://mcp.finkare.io/mcp`.
3. Claude vous redirige vers la page d'autorisation Finkare : connectez-vous avec votre compte Finkare et validez l'acces.
4. Le connecteur apparait dans la liste ; activez-le dans une conversation via le menu outils.

### Claude Code (CLI)

```bash theme={null}
claude mcp add --transport http finkare https://mcp.finkare.io/mcp
```

La premiere utilisation ouvre le navigateur pour l'autorisation OAuth.

## Authentification et securite

Le serveur implemente **OAuth 2.1** avec les metadonnees standard :

* `https://mcp.finkare.io/.well-known/oauth-protected-resource` (RFC 9728)
* `https://mcp.finkare.io/.well-known/oauth-authorization-server` (RFC 8414)
* **Dynamic Client Registration** (RFC 7591) : Claude enregistre son client automatiquement, aucune configuration manuelle de client\_id.
* **PKCE obligatoire**, tokens courts avec refresh.

Garanties cote Finkare :

* **Isolation tenant** : chaque outil filtre systematiquement par l'entreprise du compte connecte ; il est impossible d'acceder aux donnees d'une autre entreprise, y compris en fournissant des identifiants arbitraires.
* **Annotations MCP** : les outils de consultation sont marques `readOnlyHint` ; les actions d'ecriture sont explicites et confirmables par Claude.
* **Conformite recouvrement** : les actions declenchees via le connecteur passent par les memes garde-fous legaux anti-harcelement que le reste de la plateforme (fenetres horaires, plafonds de contact, opt-out).

## Outils disponibles

### Consultation (lecture seule)

| Outil                   | Description                                                                             |
| ----------------------- | --------------------------------------------------------------------------------------- |
| `search_debtor`         | Recherche un debiteur par nom (complet ou partiel)                                      |
| `get_debt_full_context` | Contexte complet d'un dossier : dette, communications, decisions IA, actions planifiees |
| `get_company_dashboard` | Statistiques globales du compte (encours, recouvre, dossiers actifs)                    |
| `get_overdue_invoices`  | Factures en retard de paiement                                                          |
| `list_invoices`         | Liste des factures avec filtres                                                         |
| `get_invoice_details`   | Details complets d'une facture                                                          |
| `list_debtors`          | Liste des debiteurs avec tri                                                            |
| `get_recent_activity`   | Activite recente : communications, decisions IA, paiements                              |
| `get_upcoming_actions`  | Prochaines actions de relance planifiees                                                |
| `get_payment_status`    | Statut de paiement d'un dossier                                                         |
| `check_proof_status`    | Statut de verification d'une preuve de paiement                                         |

### Actions

| Outil                  | Description                                                                             |
| ---------------------- | --------------------------------------------------------------------------------------- |
| `modify_cascade`       | Pause, reprise, acceleration ou report de la cascade de relance ; passage au judiciaire |
| `toggle_negotiation`   | Autoriser ou bloquer la negociation des penalites de retard                             |
| `waive_penalties`      | Abandonner les penalites de retard (soumis a conditions de score)                       |
| `add_note`             | Ajouter une note creancier a un dossier                                                 |
| `request_judicial`     | Demander le passage en procedure judiciaire (injonction de payer)                       |
| `mark_as_paid`         | Signaler un paiement recu hors plateforme et obtenir un lien de depot de preuve         |
| `upload_payment_proof` | Obtenir le lien de depot d'une preuve de paiement                                       |

Les actions sensibles (judiciaire, abandon de penalites) sont soumises aux memes regles metier que dans l'application : le connecteur ne permet rien de plus que ce que votre compte autorise.

## Donnees et confidentialite

* Le serveur ne restitue que les donnees du compte authentifie ; aucune donnee n'est partagee avec d'autres clients Finkare.
* Les conversations avec Claude sont soumises aux conditions d'Anthropic ; Finkare ne recoit que les appels d'outils, jamais le reste de la conversation.
* Voir [Securite](/security/overview) et [Confidentialite des donnees](/security/data-privacy).

## Support

Un probleme avec le connecteur ? Contactez [support@finkare.io](mailto:support@finkare.io) en precisant « Connecteur MCP » dans l'objet.