Connecter Sparkier à votre assistant IA

Le serveur MCP Sparkier permet à un grand modèle de langage (LLM) d'interagir avec votre compte Sparkier : lister et gérer vos Sparks, consulter et modifier votre profil consultant (brouillon et publication), gérer vos posts sociaux (LinkedIn), gérer vos articles liés à un Spark, et consulter vos livrables de consultation (comptes-rendus de séance). L'authentification se fait via OAuth : vous autorisez une fois l'assistant, puis il peut appeler les outils avec vos droits.

Choisissez votre assistant pour voir les instructions détaillées :

• ChatGPT
• Mistral
• Claude

ChatGPT

Pour utiliser tous les outils Sparkier (et pas seulement search/fetch), il faut activer le Developer Mode.

URL à utiliser

https://www.sparkier.io/api/mcp

Étapes

1. Allez dans la rubrique Applications de ChatGPT.
2. En haut à droite, cliquez sur l'icône Paramètres.
3. Cliquez sur Paramètres avancés.
4. Activez le mode développeur
5. Cliquez sur Créer une appli en haut
6. Saisissez l'URL du serveur MCP ci-dessus. Choisissez OAuth si proposé (Sparkier utilise OAuth).

À la première utilisation, autorisez l'accès à Sparkier. Vous pouvez ensuite demander à ChatGPT d'utiliser les outils (par ex. « Liste mes Sparks », « Crée un Spark avec le titre X », « Mets à jour le brouillon de mon article lié au Spark Y » ou « Liste mes comptes-rendus de consultation »).

Mistral

URL à utiliser

https://www.sparkier.io/api/mcp

Étapes

1. Ouvrez l'interface Mistral (Le Chat ou celle de votre abonnement).
2. Allez dans Settings (ou Paramètres) → Connectors / Custom connectors.
3. Cliquez sur Add custom connector (ou équivalent).
4. Collez l'URL ci-dessus.
5. Enregistrez, puis connectez-vous à Sparkier lorsque demandé et validez l'autorisation.

Après connexion, les outils Sparkier (Sparks, profil consultant, posts sociaux, articles et livrables de consultation) sont disponibles pour l'assistant.

Claude

URL à utiliser

https://www.sparkier.io/api/mcp

Étapes

Pour Claude l'utilisation du MCP est seulement possible dans l'application.

1. Ouvrez l'application Claude
2. Allez dans Paramètres -> Développeur
3. Cliquez sur Edit Config.
4. Cela vous ouvre un fichier. Ouvrez le dans votre éditeur de texte favori et remplacez le contenu par le texte suivant.

{
  "mcpServers": {
    "sparkier": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://www.sparkier.io/api/mcp"
      ]
    }
  },
  "preferences": {
    "coworkScheduledTasksEnabled": false,
    "sidebarMode": "chat",
    "coworkWebSearchEnabled": true
  }
}

Dépannage

• Rien ne se connecte : vérifiez que l'URL utilisée est bien https://www.sparkier.io/api/mcp.
• Erreur 401 / authentification : refaites l'autorisation OAuth (déconnectez le connecteur puis reconnectez-vous).
• Boucle de reconnexion : supprimez le connecteur dans les paramètres de l'assistant, puis ajoutez-le à nouveau avec la même URL.

Ressources et outils MCP disponibles

Vue d'ensemble

Ressource (lecture sans outil)

Sparks (offres de consulting)

Profil consultant (page vitrine)

Posts sociaux (LinkedIn)

Articles (liés aux Sparks)

Livrables (comptes-rendus de consultation)

Lecture seule. Les livrables sont des comptes-rendus générés après une séance (sections markdown : contexte, participants, synthèse, prochaines étapes, etc.).

Exemples de demandes à l'assistant :

• Consultant : « Liste mes comptes-rendus de consultation » → my_deliverables_list
• Consultant : « Montre-moi le compte-rendu de ma dernière séance avec Marie » → my_deliverables_list puis deliverable_get
• Client : « Quels comptes-rendus ai-je reçus ? » → my_deliverables_list
• Client : « Résume-moi le compte-rendu de ma consultation du 15 mars » → deliverable_get

Codes d'erreur

Les outils peuvent retourner les codes d'erreur suivants dans le champ code de la réponse :