# Configuration

Brancher le connecteur IA Fonciq dans ChatGPT ou Claude — annuaire, connecteur personnalisé, OAuth sur fonciq.ca ou clé pour d’autres clients MCP.

Utilisez l’**adresse du connecteur** **`https://mcp.fonciq.ca/v1/`** (Streamable HTTP, sans session). L’alias `https://mcp.fonciq.ca/v1/mcp` est équivalent.

**OAuth** : connexion sécurisée via fonciq.ca — vous vous identifiez une fois et autorisez l’assistant à utiliser votre portefeuille et vos comptes Registre.

## Prérequis

- Un compte **Fonciq Studio** pour votre organisation.
- Au moins un **compte Registre** ajouté dans [Studio → Développeurs → Comptes Registre](https://fonciq.ca/studio/developpeurs#registre) avant de commander un index, un acte ou un plan.
- Choisir le **mode Test** (clé `fq_test_…` ou connexion OAuth en essai) pour la formation, ou le **portefeuille réel** pour les dossiers clients.

## Claude

**Recommandé :** ouvrez [Fonciq dans l’annuaire Claude](https://claude.ai/directory/fonciq) et ajoutez le connecteur en un clic. Vous serez invité à vous connecter sur **fonciq.ca** et à consentir à l’accès au portefeuille et aux comptes Registre de votre organisation.

<details>
<summary>Pour les équipes TI — configuration manuelle (Claude Desktop, Claude Code)</summary>

Serveur MCP distant HTTP :

```json
{
  "mcpServers": {
    "fonciq": {
      "url": "https://mcp.fonciq.ca/v1/"
    }
  }
}
```

Complétez la connexion OAuth lorsque le client la propose, ou ajoutez une clé d’essai dans les en-têtes si votre client le permet (voir le Studio développeur).

Claude Code en ligne de commande :

```bash
claude mcp add --transport http fonciq https://mcp.fonciq.ca/v1/
```

</details>

## ChatGPT

**Offert** via **connecteur personnalisé** (annuaire public ChatGPT : bientôt).

1. Activez le **mode développeur** dans ChatGPT.
2. Ajoutez un connecteur avec l’URL `https://mcp.fonciq.ca/v1/`.
3. Lorsque ChatGPT le demande, **connectez-vous à Fonciq via OAuth** sur fonciq.ca et acceptez les autorisations (connexion sécurisée en une étape).

Aucune clé à copier dans ChatGPT lorsque OAuth est utilisé : le portefeuille et les comptes Registre liés à votre compte Studio s’appliquent.

## Cursor, Codex et autres clients MCP

Dans les réglages MCP du produit, ajoutez un serveur **HTTP distant** avec l’URL ci-dessus.

- **OAuth** — préféré lorsque le client le supporte (même émetteur `https://fonciq.ca` que ChatGPT).
- **Clé d’API** — en-tête `Authorization: Bearer fq_test_…` (essai) ou `fq_live_…` (portefeuille réel) depuis le [tableau de bord développeur](https://fonciq.ca/studio/developpeurs). N’utilisez que des clés d’essai dans la documentation et les captures d’écran.

## Après la connexion

Posez une question en langage naturel (voir [Exemples](/exemples)). Dans les captures d’écran et les fils partagés, n’affichez que des clés **d’essai** ou masquez les jetons OAuth. Si une action est refusée, consultez [Erreurs et authentification](/erreurs-limites).

English: [Setup](/en/configuration).