Connexion à Well

VérifiéSûr

Authentifiez et vérifiez la connexion au MCP Well, confirmez le fonctionnement des outils et découvrez quoi demander.

Spar Skills Guide Bot
ProductiviteDébutant
22/07/2026
Claude Code
#mcp#oauth-setup#well-plugin#troubleshooting#accounting

Recommandé pour

Synthèse automatique

Guide l'utilisateur pas à pas pour enregistrer, authentifier et vérifier la connexion au serveur MCP Well, puis propose des requêtes de départ.

Points forts

  • Déroule la configuration en étapes courtes et saute celles déjà réalisées
  • Distingue clairement une erreur d'authentification d'une indisponibilité temporaire des données
  • Valide la connexion par un appel réel à well_get_schema avec un message de confirmation
  • Propose des prompts concrets et signale les skills Well plus avancés

Limites

  • Spécifique au plugin Well et à Claude Code, inutilisable ailleurs
  • Ne couvre pas le dépannage au-delà du renvoi vers l'étape d'authentification
Quand l'utiliser

À lancer juste après l'installation du plugin Well ou dès que les outils Well ne répondent plus.

Quand l'éviter

Ne pas l'utiliser pour d'autres serveurs MCP ou pour des analyses comptables déjà couvertes par les skills Well dédiés.

Analyse de sécurité

Sûr
Score qualité84/100

This is a pure onboarding/verification guide for an MCP server connection. It contains no shell commands, no network fetches, no credential handling beyond pointing the user at the host's built-in OAuth browser flow, and no instructions to read or transmit files or secrets. The only tool call it suggests is `well_get_schema`, a read-only schema probe, so there is no meaningful execution risk.

Aucun point d'attention détecté

Comment cette analyse est faite

Exemples

First-time setup
I just installed the Well plugin — can you connect it and check that it works?
Connection not working
/well:connect — the Well MCP isn't working, nothing happened when I tried it.
After reinstall
I reinstalled the Well plugin, help me re-authenticate and confirm my workspace data is reachable.

name: connect description: Connect and verify the Well MCP — authenticate, confirm the tools work, and show what to ask. Use when the user runs /well:connect, just installed the Well plugin, or says the Well connection/MCP "isn't working" / "nothing happened". disable-model-invocation: false

Connect to Well

Run this right after installing the Well plugin, or whenever the Well tools aren't responding. Walk the user through it conversationally — do not dump all steps at once if a step is already done.

1. Confirm the MCP server is registered

Installing the plugin auto-adds the well MCP server (it is bundled in the plugin manifest). If the user just installed it, make sure it's active:

  • Tell them to run /reload-plugins if they haven't since installing.
  • The server should now appear when they run /mcp.

2. Authenticate (one time, browser sign-in — no API key)

The Well MCP uses OAuth, so the first connection needs a one-time sign-in:

Run /mcp, select well, and choose Authenticate. A browser opens — sign in to your Well account and approve. No API key, no config.

If /mcp shows well as already authenticated, skip this.

3. Verify it works

Call well_get_schema (no arguments) to confirm the connection is live. If it returns the list of roots (companies, invoices, transactions, ledger_accounts, …), the connection is working — tell the user "Connected ✓, N data types available."

If it returns an auth error, send them back to step 2. If it returns a server error on the heavy roots, the connection is fine but the workspace data path may be temporarily unavailable — say so rather than implying the setup failed.

4. Show what to ask

Once connected, offer 3 concrete starting prompts so the user gets value immediately:

  • "Summarize last month's cash flow"
  • "List my unpaid invoices over €5,000"
  • "Build my compte de résultat for the last quarter"

Mention the deeper skills are available too: /well:reconciliation, /well:vat-summary, /well:ar-aging, /well:month-end-close, /well:compte-de-resultat, /well:balance-sheet, /well:cash-flow-forecast.

Note on billing

Tool calls use Well credits, billed to the workspace plan. Mention this once if the user asks about cost — do not interrupt every call.

Du fichier au premier essai

Le téléchargement contient exactement le contenu affiché sur cette fiche. Cette copie peut différer de la dernière version du dépôt source.

Consulter la source et ses fichiers annexes

Ce téléchargement contient uniquement SKILL.md. Les scripts, références, modèles et dépendances éventuels ne sont pas inclus. Récupérez les fichiers nécessaires depuis la source en conservant leur arborescence avant de poursuivre.

1. Télécharger le fichier

Télécharger SKILL.md

Depuis la racine d’un projet de test, enregistrez le fichier sous .skill-downloads/connect-to-well-mrwakfki/SKILL.md, ou utilisez la commande suivante. Ce dossier sert à examiner la skill avant son installation.

Commande pour macOS/Linux ou WSL : un shell POSIX et curl sont nécessaires. Sous Windows sans WSL, utilisez le bouton de téléchargement et créez le dossier manuellement.

mkdir -p '.skill-downloads/connect-to-well-mrwakfki' && curl --fail --show-error --location 'https://skills-guides.com/api/skills/connect-to-well-mrwakfki/download' --output '.skill-downloads/connect-to-well-mrwakfki/SKILL.md.part' && mv '.skill-downloads/connect-to-well-mrwakfki/SKILL.md.part' '.skill-downloads/connect-to-well-mrwakfki/SKILL.md'

2. Vérifier les prérequis

Lisez SKILL.md avant de l’utiliser. Si le fichier cite des scripts ou services externes, examinez-les et préparez les accès nécessaires dans votre environnement de test.

Aucune section de prérequis reconnue dans ce fichier. Cela ne signifie pas qu’il est autonome : les bibliothèques, outils et accès peuvent être cités ailleurs dans le contenu ou dans le dépôt source.

Les plateformes de la fiche sont des indications du catalogue. Les chemins ci-dessous suivent la documentation des outils ; ils ne prouvent pas que cette skill y a été exécutée. Aucune version minimale de ces outils n’est attestée pour cette fiche.

3. Charger la skill

Après vérification, copiez le dossier complet dans le projet avec l’une des commandes ci-dessous, puis ouvrez une nouvelle session de l’outil. La commande s’arrête si un dossier du même nom existe déjà : comparez les fichiers avant de le remplacer.

Claude Code
test -f '.skill-downloads/connect-to-well-mrwakfki/SKILL.md' && test -s '.skill-downloads/connect-to-well-mrwakfki/SKILL.md' && mkdir -p '.claude/skills' && test ! -e '.claude/skills/connect' && cp -R '.skill-downloads/connect-to-well-mrwakfki' '.claude/skills/connect'

OpenSkills

OpenSkills doit déjà être installé. La procédure locale install/read est contrôlée avec OpenSkills 1.5.0, qui exige Node.js ≥ 20.6.0. Aucun slug du catalogue n’est résolu automatiquement.

Installation officielle d’OpenSkills
openskills install './.skill-downloads/connect-to-well-mrwakfki'

openskills read 'connect-to-well-mrwakfki'

La lecture doit afficher le contenu du fichier installé et son dossier de base. Elle ne lance ni la skill ni ses dépendances.

Pour un agent qui lit AGENTS.md, synchronisez ensuite l’index. Cette commande modifie AGENTS.md : relisez le diff avant de l’utiliser.

openskills sync

Mode manuel ou autre outil : joignez SKILL.md à une conversation, ou ouvrez-le dans un agent capable de lire les fichiers. Ajoutez les ressources annexes nécessaires. Il n’existe pas de dossier universel reconnu par tous les outils.

4. Faire un premier essai

Utilisez une entrée courte et fictive : un endpoint d’API, un petit document ou un brief d’interface. Dans une nouvelle conversation, joignez le fichier ou donnez son chemin à l’agent, puis adaptez cette demande :

Lis .skill-downloads/connect-to-well-mrwakfki/SKILL.md et applique ses instructions à cet exemple : [décrire une entrée de test]. Indique les fichiers, dépendances ou accès qui manquent. Produis le résultat demandé par la skill sans inventer de données ni exécuter de script non examiné.

Résultat attendu : une sortie correspondant aux instructions de la skill, ou une liste précise des prérequis manquants. Une simple confirmation de lecture ne valide pas le premier usage. Si une ressource externe est indisponible, ce parcours reste à tester.

Skills similaires