Collega SpeakPen a Obsidian e agli assistenti IA

Per gli agenti IA

Stai aiutando l'utente a collegare SpeakPen, la sua app di note vocali. Il server MCP è https://speakpen.app/mcp (Streamable HTTP, sola lettura, accesso con OAuth). Capisci in quale client stai girando, segui la sua sezione qui sotto e avvisa l'utente quando deve fare clic su Consenti nel browser.

Questa pagina è disponibile anche come Markdown semplice: https://speakpen.app/connect.md

L'accesso è in sola lettura e riguarda solo le note, mai l'audio. Limite: 60 chiamate agli strumenti al minuto.

Strumenti: searchfetchlist_recent_notes

Claude Code

Aggiungi il server:

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

Poi esegui /mcp dentro Claude Code, scegli speakpen e accedi. Si apre il browser: accedi a SpeakPen e fai clic su Consenti.
```
/mcp
```
Facoltativo: la skill di SpeakPen insegna a Claude Code quando guardare nelle tue note. Il plugin aggiunge anche il server speakpen, quindi puoi installarlo al posto del comando qui sopra:
```
/plugin marketplace add Qumge/speakpen-skill
/plugin install speakpen@speakpen
```

Codex CLI

Aggiungi il server:

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

Accedi. Si apre il browser: accedi a SpeakPen e fai clic su Consenti.
```
codex mcp login speakpen
```

Cursor

Aggiungi questo a ~/.cursor/mcp.json (o a .cursor/mcp.json in un progetto):

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

Quando Cursor ti chiede di accedere a speakpen, accedi a SpeakPen nel browser e fai clic su Consenti.

VS Code

Aggiungi questo a .vscode/mcp.json nel tuo workspace, con un token al posto di YOUR_TOKEN:

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

Crea il token in Impostazioni → Connessioni → Sviluppatori.

Gemini CLI

Aggiungi il server:

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

Poi, dentro Gemini CLI, accedi. Si apre il browser: accedi a SpeakPen e fai clic su Consenti.
```
/mcp auth speakpen
```

Altri client MCP

In qualsiasi client MCP che supporti i server remoti, aggiungi un server remoto (Streamable HTTP) con questo indirizzo, poi accedi quando richiesto:

https://speakpen.app/mcp

Se il tuo client non può accedere con OAuth, crea un token in Impostazioni → Connessioni → Sviluppatori e invialo a ogni richiesta:

Authorization: Bearer YOUR_TOKEN

ChatGPT

ChatGPT e Claude li configuri tu, nelle loro impostazioni. Un agente non può aprirle al posto tuo.

In ChatGPT, aggiungi un server MCP personalizzato (la guida di ChatGPT spiega dove farlo; alcuni piani e workspace non lo permettono).
Usa questo indirizzo e scegli l'accesso con OAuth:
```
https://speakpen.app/mcp
```
Accedi a SpeakPen e fai clic su Consenti.

Claude.ai and Claude Desktop

Apri Customize → Connectors, fai clic su + Add, poi su Add custom connector.
Chiamalo SpeakPen, incolla questo indirizzo e fai clic su Continue. Lascia le impostazioni di accesso come sono, fai di nuovo clic su Continue, poi su Add:
```
https://speakpen.app/mcp
```
Quando Claude ti chiede di accedere, accedi a SpeakPen e fai clic su Consenti.

I passaggi sono gli stessi in Claude Desktop.

Obsidian

In Obsidian: Impostazioni → Plugin della community → Sfoglia → cerca «SpeakPen Sync» → Installa e abilita.
In SpeakPen, apri Impostazioni → Connessioni e fai clic su «Genera token» sulla scheda di Obsidian. Copia il token: viene mostrato una sola volta.
Apri le impostazioni di SpeakPen Sync in Obsidian e incolla il token nel campo «API token».

Le note si sincronizzano in un solo senso: da SpeakPen al tuo vault.

Come le note vocali si sincronizzano con Obsidian →

Verifica che funzioni

Chiedi al tuo assistente:

Cosa ho registrato di recente?

Scollega

Apri Impostazioni → Connessioni. Fai clic su «Scollega» accanto a un assistente, oppure revoca un token in Sviluppatori. L'accesso si interrompe subito.

Privacy

Gli assistenti possono solo leggere le tue note. Non possono creare, modificare né eliminare nulla, e non ricevono mai il tuo audio. Puoi scollegarli in qualsiasi momento.