Connecter SpeakPen à Obsidian et aux IA

Pour les agents IA

Vous aidez l'utilisateur à connecter SpeakPen, son application de notes vocales. Le serveur MCP est https://speakpen.app/mcp (Streamable HTTP, lecture seule, connexion OAuth). Déterminez dans quel client vous tournez, suivez sa section ci-dessous, et prévenez l'utilisateur quand il doit cliquer sur Autoriser dans son navigateur.

Cette page est aussi disponible en Markdown brut : https://speakpen.app/connect.md

L'accès est en lecture seule et ne couvre que les notes, jamais l'audio. Limite : 60 appels d'outils par minute.

Outils : searchfetchlist_recent_notes

Claude Code

Ajoutez le serveur :

claude mcp add --transport http speakpen https://speakpen.app/mcp

Puis exécutez /mcp dans Claude Code, choisissez speakpen et connectez-vous. Votre navigateur s'ouvre : connectez-vous à SpeakPen et cliquez sur Autoriser.
```
/mcp
```
Facultatif : le skill SpeakPen apprend à Claude Code quand chercher dans vos notes. Le plugin ajoute aussi le serveur speakpen, vous pouvez donc l'installer à la place de la commande ci-dessus :
```
/plugin marketplace add Qumge/speakpen-skill
/plugin install speakpen@speakpen
```

Codex CLI

Ajoutez le serveur :

codex mcp add speakpen --url https://speakpen.app/mcp

Connectez-vous. Votre navigateur s'ouvre : connectez-vous à SpeakPen et cliquez sur Autoriser.
```
codex mcp login speakpen
```

Cursor

Ajoutez ceci à ~/.cursor/mcp.json (ou à .cursor/mcp.json dans un projet) :

{
  "mcpServers": {
    "speakpen": {
      "url": "https://speakpen.app/mcp"
    }
  }
}

Quand Cursor vous demande de vous connecter à speakpen, connectez-vous à SpeakPen dans votre navigateur et cliquez sur Autoriser.

VS Code

Ajoutez ceci à .vscode/mcp.json dans votre espace de travail, avec un jeton à la place de YOUR_TOKEN :

{
  "servers": {
    "speakpen": {
      "type": "http",
      "url": "https://speakpen.app/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Créez le jeton dans Paramètres → Connexions → Développeurs.

Gemini CLI

Ajoutez le serveur :

gemini mcp add --transport http speakpen https://speakpen.app/mcp

Puis, dans Gemini CLI, connectez-vous. Votre navigateur s'ouvre : connectez-vous à SpeakPen et cliquez sur Autoriser.
```
/mcp auth speakpen
```

Autres clients MCP

Dans tout client MCP qui prend en charge les serveurs distants, ajoutez un serveur distant (Streamable HTTP) avec cette adresse, puis connectez-vous quand on vous le demande :

https://speakpen.app/mcp

Si votre client ne peut pas se connecter avec OAuth, créez un jeton dans Paramètres → Connexions → Développeurs et envoyez-le avec chaque requête :

Authorization: Bearer YOUR_TOKEN

ChatGPT

ChatGPT et Claude se configurent vous-même, dans leurs propres paramètres. Un agent ne peut pas les ouvrir à votre place.

Dans ChatGPT, ajoutez un serveur MCP personnalisé (l'aide de ChatGPT explique où le faire ; certains forfaits et espaces de travail ne le permettent pas).
Utilisez cette adresse et choisissez la connexion OAuth :
```
https://speakpen.app/mcp
```
Connectez-vous à SpeakPen et cliquez sur Autoriser.

Claude.ai and Claude Desktop

Ouvrez Customize → Connectors, cliquez sur + Add, puis sur Add custom connector.
Nommez-le SpeakPen, collez cette adresse et cliquez sur Continue. Laissez les paramètres de connexion tels quels, cliquez de nouveau sur Continue, puis sur Add :
```
https://speakpen.app/mcp
```
Quand Claude vous demande de vous connecter, connectez-vous à SpeakPen et cliquez sur Autoriser.

Les étapes sont les mêmes dans Claude Desktop.

Obsidian

Dans Obsidian : Paramètres → Plugins communautaires → Parcourir → recherchez « SpeakPen Sync » → Installez et activez.
Dans SpeakPen, ouvrez Paramètres → Connexions et cliquez sur « Générer un jeton » sur la carte Obsidian. Copiez le jeton : il n'est affiché qu'une seule fois.
Ouvrez les paramètres de SpeakPen Sync dans Obsidian et collez le jeton dans le champ « API token ».

Les notes se synchronisent dans un seul sens : de SpeakPen vers votre coffre.

Comment les notes vocales se synchronisent avec Obsidian →

Vérifier que ça marche

Demandez à votre assistant :

Qu'ai-je enregistré récemment ?

Déconnecter

Ouvrez Paramètres → Connexions. Cliquez sur « Déconnecter » à côté d'un assistant, ou révoquez un jeton sous Développeurs. L'accès s'arrête immédiatement.

Confidentialité

Les assistants peuvent seulement lire vos notes. Ils ne peuvent rien créer, modifier ni supprimer, et ne reçoivent jamais votre audio. Vous pouvez les déconnecter à tout moment.