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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.