MCP-server

Accountrechten vereist

MCP-toegang is alleen beschikbaar als die al is inbegrepen in de huidige gebruiksrechten van het ingelogde Savebase-account.

Savebase stelt een Model Context Protocol (MCP) server waarmee AI je bladwijzers zoekt en leest. Vraag Claude, ChatGPT of Cursor bijvoorbeeld "Wat had ik opgeslagen over kettlebelltraining?" en je Savebase-bibliotheek wordt direct bevraagd.

Overzicht

MCP is een open standaard waarmee AI-applicaties verbinding kunnen maken met externe gegevensbronnen. Savebase biedt een MCP-compatibel HTTP-eindpunt dat je AI-assistent alleen-lezen toegang geeft tot je bladwijzers, mappen en tags.

Installeer voor ChatGPT de gepubliceerde Savebase-plug-in. Gebruik voor Claude, Cursor, VS Code en andere MCP-clients dit serveradres:

text

https://mcp.savebase.space/mcp

Log gewoon met Savebase in zoals bij andere apps, zonder API-sleutels of tokens te kopiëren. MCP is alleen-lezen: gekoppelde apps kunnen niets toevoegen, wijzigen of verwijderen.

Vereisten

Een Savebase-account waarvan de huidige gebruiksrechten MCP-toegang omvatten
De gepubliceerde Savebase-plug-in voor ChatGPT, of een MCP-compatibele client zoals Claude, Cursor of VS Code

Claude (web, desktop, mobiel)

Claude-connectoren openen

In claude.ai of ga in de desktopapp naar Instellingen → Connectors.

Een aangepaste connector toevoegen

Klik op Aangepaste connector toevoegen, noem deze Savebase, en plak https://mcp.savebase.space/mcp.

Koppelen en inloggen

Klik op Toevoegen → Verbinden, meld je aan met je Savebase-account en geef toestemming. De Savebase-tools zijn nu beschikbaar in je gesprekken.

Werkt ook op mobiel

Een externe connector die op claude.ai is toegevoegd, kan in Claude voor iOS en Android worden gebruikt, hoewel nieuwe servers niet rechtstreeks vanuit Claude Mobile kunnen worden toegevoegd. Zie de documentatie van Anthropic: actuele ondersteuning voor externe MCP.

Claude Code

Voeg de server toe

Voer het volgende uit in je terminal. Laat weg: --scope user als je het alleen in dit project wilt.

bash

claude mcp add --transport http --scope user savebase https://mcp.savebase.space/mcp

Verifiëren

Start Claude Code en voer uit /mcp. Er opent een browservenster — meld je aan en geef toestemming.

Controleren

Uitvoeren claude mcp list. Savebase hoort als verbonden te worden weergegeven.

Cursor

Je MCP-configuratie openen

Ga naar Instellingen → MCP → Nieuwe server toevoegen, of bewerk ~/.cursor/mcp.json direct.

Voeg de Savebase-server toe

Voeg het onderstaande item toe. Let op: er is geen headers blok; authenticatie gebeurt in de browser.

json

{
  "mcpServers": {
    "savebase": {
      "url": "https://mcp.savebase.space/mcp"
    }
  }
}

Herladen en toestemming geven

Herlaad Cursor. De server geeft aan dat inloggen nodig is: klik erop, log in en geef toestemming.

Belangrijk voor Cursor-gebruikers

Selecteer altijd HTTP als servertype, niet SSE. Verwijder een oude SSE-vermelding, voeg opnieuw toe als HTTP en herstart Cursor.

ChatGPT

De Savebase-plug-in openen

Bezoek de officiële Vermelding van de Savebase-plug-in in ChatGPT.

Installeren en inloggen

Selecteer de plusknop om Savebase te installeren. Meld je wanneer daarom wordt gevraagd aan met je Savebase-account en keur alleen-lezen toegang tot je bibliotheek goed.

Savebase gebruiken in een chat

Begin een nieuw ChatGPT Work-gesprek en roep Savebase aan met @Savebase, of kies deze in het opstelvak wanneer je wilt dat ChatGPT je bibliotheek doorzoekt.

Geen ontwikkelaarsconfiguratie nodig

De openbare plug-in vervangt de oude ontwikkelaarsmodus en aangepaste MCP-configuratie voor ChatGPT. De bovenstaande MCP-server-URL blijft in gebruik voor andere compatibele clients.

VS Code

Voeg de server toe

Open het opdrachtenpalet en voer het volgende uit: MCP: server toevoegen, kies HTTP, en plak https://mcp.savebase.space/mcp.

Of bewerk de configuratie rechtstreeks

Toevoegen aan .vscode/mcp.json in je werkruimte:

json

{
  "servers": {
    "savebase": {
      "type": "http",
      "url": "https://mcp.savebase.space/mcp"
    }
  }
}

Aanmelden

Start de server vanuit de MCP-weergave. Er opent een browservenster om in te loggen; keur dit goed en de tools verschijnen in de agentmodus van Copilot Chat.

Verbonden apps beheren

Elke app waarbij je inlogt, staat vermeld onder Instellingen → MCP-server → Verbonden apps, met de datum waarop je deze koppelde en wanneer deze je bibliotheek voor het laatst heeft gelezen. Klik op Ontkoppelen om toegang meteen in te trekken.

Wat een app kan zien

Gekoppelde apps krijgen alleen-lezen toegang tot je bladwijzers, notities, transcripties, mapnamen en tags. Ze zien je wachtwoord nooit en kunnen je bibliotheek niet wijzigen.

Savebase stuurt alleen gegevens wanneer een verzoek de verbonden assistent de MCP-server laat raadplegen; het pusht je bibliotheek niet op de achtergrond naar verbonden apps en gebruikt die niet om een Savebase-model te trainen. Zodra gegevens een assistent bereiken, gelden de privacy- en gegevensgebruiksvoorwaarden van die aanbieder. Zie de Privacybeleid van Savebase voor de volledige lijst van wat een gekoppelde app kan ontvangen.

Geavanceerd: handmatig toegangstoken

Sommige oudere MCP-clients kunnen niet via de browser inloggen en hebben in plaats daarvan een token in een header nodig. Open daarvoor Instellingen → MCP-server → Geavanceerd, voer een label in en klik op Token genereren. Het token begint met sb- en blijft geldig tot je hem intrekt.

json

{
  "mcpServers": {
    "savebase": {
      "url": "https://mcp.savebase.space/mcp",
      "headers": {
        "Authorization": "Bearer sb-YOUR_MCP_TOKEN"
      }
    }
  }
}

Tokenbeveiliging

Savebase bewaart nooit je onbewerkte token, alleen een SHA-256-hash. Het wordt één keer getoond bij het aanmaken, dus kopieer het meteen. Je kunt het altijd intrekken via Instellingen → MCP-server.

Beschikbare tools

Na het verbinden heeft je AI-assistent toegang tot deze negen tools. Ze kunnen allemaal alleen lezen: geen enkele kan iets in je bibliotheek wijzigen.

Tool	Beschrijving
`search_bookmarks`	Zoek op trefwoord in titels, content, notities, auteurs, URL's en videotranscripties. Beperk de zoekopdracht tot specifieke velden en filter op platform, map, tag, maker, datumbereik of de aanwezigheid van een transcriptie.
`list_bookmarks`	Blader zonder trefwoord, met optionele filters voor platform, map, tag en datum
`list_recent_bookmarks`	Wat je vandaag, deze week, deze maand of in de laatste 7 of 30 dagen opsloeg
`get_bookmark`	Alle details van één bladwijzer, met tags, mappen en een transcriptvoorbeeld
`get_bookmark_transcript`	Lees een lange videotranscriptie in delen, zodat niet alles tegelijk hoeft te laden
`find_bookmark_by_url`	Controleer of een link al is opgeslagen. Negeert trackingparameters zoals `utm_source`.
`list_folders`	Je mappen weergeven, inclusief onderliggende mappen
`list_tags`	Al je tags weergeven
`get_library_stats`	Totalen, uitsplitsing per platform, je drukste mappen en tags en recente opslagactiviteit

Voorbeeldprompts

Stel je AI-assistent bijvoorbeeld deze vragen:

"Wat had ik opgeslagen over kettlebelltraining?"
"Laat alles zien wat ik vorige maand van Reddit heb opgeslagen."
"Vind de opgeslagen video waarin iemand uitlegt hoe je een Cloudflare Worker instelt."
"Heb ik deze link al opgeslagen?" — plak een URL
"Vind alle bladwijzers in mijn map 'Ontwerpinspiratie'."
"Welke artikelen heb ik de tag 'AI' gegeven?"
"Geef me een overzicht van mijn bibliotheek — hoeveel items, waarvandaan, belangrijkste tags."
"Vat de berichten samen die ik vorige week heb opgeslagen."

Zoeken naar wat er in een video is gezegd

Als je een transcriptie van een opgeslagen video hebt gemaakt, is ook de gesproken inhoud doorzoekbaar. Een vraag zoals "hoe doe ik X" kan een stap vinden die iemand mondeling uitlegde in een clip die je maanden geleden opsloeg.

Problemen oplossen

Probleem	Oplossing
Savebase is niet beschikbaar in ChatGPT	Open de gepubliceerde Savebase-plug-in, installeer deze en start een nieuw ChatGPT Work-gesprek. Je hoeft geen aangepaste app meer te maken in de ontwikkelaarsmodus.
De app vraagt je nooit om in te loggen	Controleer of de URL exact gelijk is aan `https://mcp.savebase.space/mcp` — bij een typefout vindt de client de login niet.
"MCP-toegang niet beschikbaar" bij het aanmelden	Meld je aan met een account waarvan de huidige rechten MCP-toegang omvatten, of neem contact op met Savebase-ondersteuning als je denkt dat die rechten niet kloppen.
"Dit verzoek is verlopen"	Autorisatieverzoeken zijn 10 minuten geldig. Start de koppeling opnieuw vanuit je AI-app.
Verbinding werkt niet meer	Controleer of de app nog staat onder Instellingen → MCP-server → Gekoppelde apps. Koppel opnieuw vanuit de app als die was losgekoppeld.
De server toont “errored” in Cursor	Verwijder de oude Savebase-vermelding in Cursor-instellingen → MCP. Voeg deze opnieuw toe als Type: HTTP (niet SSE), en start Cursor vervolgens helemaal opnieuw op.
Tools worden niet getoond	Start je AI-client opnieuw nadat je de configuratie hebt toegevoegd. Sommige clients vereisen een volledige herstart om nieuwe MCP-servers te herkennen.
Geen resultaten	Zorg dat er bladwijzers in je Savebase-bibliotheek zijn opgeslagen. De MCP-server doorzoekt alleen je eigen gegevens.
Een handmatig token kwijt	Tokens worden maar één keer getoond. Trek de oude in via Instellingen → MCP-server → Geavanceerd en maak een nieuwe.

Snelle herstelstappen

Als het niet werkt: (1) Ontkoppel Savebase in je AI-app, (2) verwijder het via Instellingen → MCP-server → Gekoppelde apps, (3) voeg de connector opnieuw toe en log in, (4) start de AI-client volledig opnieuw.

Regelengine

Overzicht en installatie