---
title: "Connecter Claude et d’autres assistants IA à Talkspirit"
description: "Connectez Claude, ou tout assistant IA compatible MCP, à votre organisation Talkspirit. Connectez-vous depuis Claude sur le web ou l’application de bureau, ou utilisez une clé MCP pour Claude Code et d’autres outils. L’assistant agit avec vos propres autorisations."
category: integrations
section: api-and-webhooks
type: Tutorial
lastUpdated: 2026-09-17
locale: fr
canonical: https://support.talkspirit.com/fr/integrations/connect-claude-and-other-ai-assistants
---

# Connecter Claude et d’autres assistants IA à Talkspirit


Talkspirit met à disposition un **serveur Model Context Protocol (MCP)** : un assistant IA comme Claude peut ainsi lire les données de votre organisation et agir dessus pour vous, par exemple consulter des tâches, en créer, soulever une tension ou mettre à jour un résultat clé. L’assistant se connecte en votre nom : il ne peut donc voir et faire que ce que vos propres autorisations permettent déjà.

**L’adresse du serveur MCP de Talkspirit est :**

```
https://mcp.talkspirit.com/mcp
```

Cette adresse est nécessaire pour chacune des méthodes ci-dessous.

**En résumé :** si vous utilisez Claude dans le navigateur ou l’application de bureau, ajoutez un connecteur personnalisé et connectez-vous avec votre compte Talkspirit. Si vous utilisez Claude Code, un autre outil IA ou un script, créez plutôt une clé MCP et transmettez-la dans un en-tête de requête.

## Avant de commencer

- Un compte Talkspirit. Tout membre peut connecter un assistant, aucun droit d’administrateur n’est nécessaire.
- Vos propres autorisations s’appliquent. Deux collègues posant la même question peuvent obtenir des réponses différentes, car chaque assistant ne voit que ce que cette personne peut voir.
- Sur les offres Claude Team et Enterprise, un propriétaire de votre organisation **Claude** doit parfois approuver un nouveau connecteur au préalable. Il s’agit de l’offre et du réglage de Claude, non de Talkspirit.

> **Remarque :** les étapes réalisées dans Claude se déroulent dans l’interface d’Anthropic, dont la disposition et les libellés évoluent indépendamment de Talkspirit. Si un nom a changé, cherchez l’équivalent le plus proche.

## Quelle méthode choisir ?

| Votre usage de l’assistant | Méthode | Ce qu’il vous faut |
| --- | --- | --- |
| Claude dans un navigateur web | Connexion | Vos identifiants Talkspirit |
| L’application de bureau Claude | Connexion | Vos identifiants Talkspirit |
| Claude Code, un autre outil IA ou un script | Clé MCP | Une clé commençant par `tsk_` |

La connexion est l’option la plus simple au quotidien : Talkspirit renouvelle l’accès pour vous et aucune clé n’est à conserver. Utilisez une clé MCP lorsque l’outil ne peut pas afficher de fenêtre de connexion, ce qui est le cas des outils en ligne de commande et de l’automatisation.

## Méthode 1 : Claude sur le web ou l’application de bureau

Les étapes sont identiques dans les deux cas, car les connecteurs se synchronisent depuis votre compte Claude.

1. Dans Claude, ouvrez **Paramètres → Connecteurs** et choisissez d’ajouter un connecteur personnalisé. Le chemin exact dépend de votre offre Claude et de vos autorisations.
2. Donnez un nom au connecteur, par exemple `Talkspirit`.
3. Dans le champ d’adresse du serveur, saisissez `https://mcp.talkspirit.com/mcp`.
4. Déployez **Paramètres avancés** et saisissez `mcp-claude-desktop` dans **OAuth Client ID**. C’est obligatoire : sans cela, la connexion est refusée. Laissez **OAuth Client Secret** vide.
5. Sélectionnez **Add**, puis **Connect**, et connectez-vous avec votre compte Talkspirit dans la fenêtre qui s’ouvre.

![La fenêtre « Add custom connector » de Claude, avec l’adresse du serveur MCP de Talkspirit saisie et l’OAuth Client ID mcp-claude-desktop renseigné sous Advanced settings, le champ OAuth Client Secret restant vide](/images/integrations/connect-claude-and-other-ai-assistants/01-claude-add-custom-connector.png)

Claude liste alors Talkspirit parmi ses outils connectés, prêt à être utilisé dans une conversation.

## Méthode 2 : Claude Code et autres clients MCP

Ces outils se connectent avec une clé MCP plutôt qu’avec une fenêtre de connexion. Créez d’abord la clé : ouvrez **Compte → Clés MCP**, sélectionnez **Ajouter une clé MCP**, choisissez **Lecture seule** ou **Lecture et écriture**, puis copiez la clé. La procédure complète, y compris l’expiration et la révocation, se trouve dans [Créer et gérer des clés MCP](/fr/integrations/create-and-manage-mcp-keys).

Pour **Claude Code**, lancez ceci depuis votre terminal (la page des clés MCP affiche la même commande, prête à copier) :

```bash
claude mcp add --transport http talkspirit https://mcp.talkspirit.com/mcp \
  --header "X-API-Key: tsk_<your_api_key>"
```

Ou déclarez-la dans `.mcp.json` pour un projet, ou `~/.claude.json` pour vous-même :

```json
{
  "mcpServers": {
    "talkspirit": {
      "type": "http",
      "url": "https://mcp.talkspirit.com/mcp",
      "headers": {
        "X-API-Key": "tsk_<your_api_key>"
      }
    }
  }
}
```

**Tout autre client MCP :** pointez-le vers `https://mcp.talkspirit.com/mcp` et transmettez votre clé dans un en-tête `X-API-Key` à chaque requête.

> **Attention :** traitez une clé MCP comme un mot de passe. Ne la placez jamais dans un système de gestion de versions. Conservez-la dans une variable d’environnement, un gestionnaire de mots de passe ou un gestionnaire de secrets, et utilisez une clé par machine ou par outil afin de pouvoir les révoquer indépendamment.

## Vérifier que tout fonctionne

Demandez à votre assistant qui vous êtes, par exemple *« Avec Talkspirit, qui suis-je ? »*. Il répond avec votre nom, votre organisation et la méthode d’authentification utilisée. S’il n’y parvient pas :

- **Connexion :** vérifiez que le connecteur figure dans les paramètres de Claude et que vous avez bien terminé la fenêtre de connexion Talkspirit.
- **Clé MCP :** vérifiez que la clé est toujours **Active** sur la page **Compte → Clés MCP**, et que l’en-tête est exactement `X-API-Key: tsk_…`.

## Ce que l’assistant peut faire

L’assistant lit les cercles, les rôles, les tâches, les réunions, les objectifs, les indicateurs et les publications de votre organisation, et crée ou modifie un ensemble défini d’éléments, toujours avec vos propres autorisations. Il ne modifie jamais directement un cercle ou un rôle. [Ce que le serveur MCP de Talkspirit peut faire](/fr/integrations/what-the-mcp-server-can-do) liste ce qu’il lit, crée, modifie et retire, et ce qu’il ne peut pas faire.

## Travailler avec plusieurs organisations

Les requêtes s’exécutent dans votre **organisation active**. Si vous appartenez à plusieurs organisations, l’assistant peut toutes les lister et indiquer laquelle est active, ce qui vous permet de confirmer où il travaille avant de lui demander de modifier quoi que ce soit.

Pour une connexion établie par identification, l’organisation active est celle de votre session Talkspirit. Un client qui permet de définir des en-têtes de requête peut viser une autre organisation dont vous êtes membre en envoyant son identifiant dans un en-tête `X-Tenant-Id` ; l’identifiant d’une organisation dont vous n’êtes pas membre est refusé.

## Dépannage

| Ce que vous voyez | Ce que cela signifie | Que faire |
| --- | --- | --- |
| `401 Unauthorized` | La connexion a expiré, ou la clé est mal saisie, expirée ou supprimée | Reconnectez-vous, ou vérifiez que la clé est **Active** sous **Compte → Clés MCP** et créez-en une nouvelle si besoin |
| `403 Forbidden` | Votre compte n’a pas le droit de faire cela | L’assistant n’a que vos autorisations. Vérifiez ce que votre compte peut faire dans Talkspirit |
| La connexion boucle ou est refusée | L’OAuth Client ID est absent ou incorrect | Sous **Paramètres avancés**, réglez **OAuth Client ID** sur `mcp-claude-desktop` et laissez le secret vide |
| Le serveur est injoignable, ou expire | Réseau ou pare-feu | Vérifiez que `mcp.talkspirit.com` est joignable. Les pare-feux d’entreprise le bloquent parfois |
| `404` sur un élément qui existe | Mauvais identifiant, ou élément dans une autre organisation | Demandez à l’assistant de rechercher l’élément par son nom plutôt que de fournir un identifiant, et confirmez l’organisation active |
| Une requête volumineuse expire | Requête trop large | Demandez-en une plus étroite : filtrez par cercle, ou demandez moins de champs |

## Étapes suivantes

- [Ce que le serveur MCP de Talkspirit peut faire](/fr/integrations/what-the-mcp-server-can-do)
- [Créer et gérer des clés MCP](/fr/integrations/create-and-manage-mcp-keys)
- [L’API Partenaire de Talkspirit](/fr/integrations/partner-api)
- [Comment Spark traite les données de votre organisation](/fr/administration-security/how-ai-processes-your-data)