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) et gérer vos articles liés à un Spark. 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

Allez dans la rubrique Applications de ChatGPT.
En haut à droite, cliquez sur l'icône Paramètres.
Cliquez sur Paramètres avancés.
Activez le mode développeur
Cliquez sur Créer une appli en haut
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 » ou « Mets à jour le brouillon de mon article lié au Spark Y »).

Mistral

URL à utiliser

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

Étapes

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

Après connexion, les outils Sparkier (Sparks, profil consultant, posts sociaux et articles, dont l'édition de brouillons) 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.

Ouvrez l'application Claude
Allez dans Paramètres -> Développeur
Cliquez sur Edit Config.
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

Domaine	Objet	Préfixe des outils
Sparks	Offres de consulting (titre, description, durée, prix)	`my_sparks_list`, `sparks_get`, `spark_*`
Profil	Page vitrine consultant (bio, compétences, avis)	`my_profile_get`, `profile_*`
Posts	Publications LinkedIn (brouillons, planification)	`my_posts_list`, `post_get`, `post_*`
Articles	Articles de blog liés à un Spark	`my_articles_list`, `article_get`, `article_*`

Ressource (lecture sans outil)

Ressource	URI	Description
Mes Sparks (résumé)	`sparkier://my/sparks-summary`	Liste des Sparks de l'utilisateur connecté. Retourne jusqu'à 50 Sparks, triés par date. L'assistant peut découvrir et lire cette ressource sans appeler d'outil.

Sparks (offres de consulting)

Outil	Description
my_sparks_list	Liste les Sparks. Filtres : `publicationStatus`, `sort`, `limit`, `offset`.
sparks_get	Récupère un Spark par `id` ou `slug`.
spark_create	Crée un Spark (brouillon ou publié si `publish: true`).
spark_update	Met à jour un Spark. Pour un Spark publié, crée une révision ; appeler `spark_publish` pour rendre les changements visibles.
spark_publish	Publie un brouillon. Nécessite un profil consultant complet.

Profil consultant (page vitrine)

Outil	Description
my_profile_get	Récupère le profil (fusionné avec le brouillon). Retourne `hasUnpublishedDraft` si des modifications ne sont pas publiées.
profile_draft_update	Met à jour le brouillon (nom, bio, langues, compétences, liens sociaux, avis, missions).
profile_publish	Publie le brouillon sur la page vitrine.
profile_draft_discard	Annule le brouillon sans publier.

Posts sociaux (LinkedIn)

Outil	Description
my_posts_list	Liste les posts. Filtres : `platform`, `status`, `limit`, `orderBy`, `orderDirection`.
post_get	Récupère un post par `postId`.
post_draft_create	Crée un brouillon de post.
post_draft_update	Met à jour un brouillon (content, url).
post_schedule	Planifie la publication. Sans date `scheduledFor`, Sparkier choisit le meilleur créneau. Nécessite une connexion LinkedIn établie dans Sparkier.
post_publish	Publie immédiatement sur LinkedIn. Nécessite une connexion LinkedIn établie dans Sparkier.
post_draft_discard	Supprime définitivement un brouillon de post.

Articles (liés aux Sparks)

Outil	Description
my_articles_list	Liste les articles. Filtres : `sparkId`, `status`, `includeArchived`, `limit`.
article_get	Récupère un article par `articleId`.
article_draft_create	Crée un article lié à un Spark.
article_draft_update	Met à jour un brouillon d'article.
article_publish	Publie un article.
article_unpublish	Dépublie (retour au brouillon).
article_archive	Archive (masqué des listes).

Codes d'erreur

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

Code	Quand il survient
validation_error	Paramètres invalides (format incorrect, champs requis manquants, valeurs hors limites). Corriger l'entrée et réessayer.
role_required	L'utilisateur n'a pas le rôle consultant ou admin requis pour l'action.
profile_incomplete	Profil consultant incomplet lors d'une tentative de publication d'un Spark. Demander à l'utilisateur les infos manquantes, utiliser `profile_draft_update` puis `profile_publish`, puis réessayer `spark_publish`.
duplicate_title	Le titre du Spark correspond à un autre. Changer le titre puis réessayer `spark_publish`.
duplicate_content	Le contenu du Spark est trop similaire à un autre. Personnaliser le titre ou le contenu puis réessayer `spark_publish`.
not_found	Ressource introuvable ou non autorisée (Spark, post, article, etc.). Vérifier l'ID avec l'outil de liste correspondant (`my_sparks_list`, `my_posts_list`, `my_articles_list`) puis réessayer.
not_published	Article non publié lors d'un `article_unpublish`. Demander à l'utilisateur de confirmer l'article ou utiliser `article_publish` d'abord.