AI Integration Setup (MCP)

Manage your LinkaGoGo bookmarks by chatting with AI.

Connect your favorite AI assistant to your LinkaGoGo bookmarks using the Model Context Protocol (MCP). Search, add, organize, tag, and export bookmarks conversationally — no need to open the web UI.

Requires a Plus or Premium subscription.

Choose your AI client:

Claude.ai — one-click connector, no installation
ChatGPT — connect via MCP connector
Claude Desktop — local app, requires Node.js
Cursor — AI code editor
VS Code + Copilot — GitHub Copilot MCP support
Other MCP clients — Windsurf, Zed, Continue, Cline, Claude Code

Option A: Claude.ai (Web)

The fastest way to get started. No software to install — just connect and go.

Log in to LinkaGoGo

Make sure you're logged in to LinkaGoGo in your browser. You'll need an active Plus or Premium subscription.

Add the Connector in Claude.ai

Go to claude.ai and open Settings
Navigate to Connectors (or Integrations)
Click Add Connector
Enter the URL: https://www.linkagogo.com/mcp
Click Connect

Approve Access

Claude will redirect you to a LinkaGoGo authorization page. Review the permissions and click Approve. You'll be redirected back to Claude.ai automatically.

Start Chatting

That's it! Ask Claude anything about your bookmarks:

"How many bookmarks do I have?"
"Search my bookmarks for Python tutorials"
"Add https://example.com to my Dev folder with tags 'reference' and 'docs'"
"What are my most visited bookmarks?"
"Show me my folder tree"
"Export my Recipes folder as XBEL"

ChatGPT

ChatGPT supports MCP connectors. Connect the same way as Claude.ai:

Go to chatgpt.com and open Settings
Navigate to the MCP or Connectors section
Add a new connector with URL: https://www.linkagogo.com/mcp
Approve access on the LinkaGoGo authorization page
Start chatting — ask ChatGPT to search, add, or organize your bookmarks

Claude Desktop (App)

For power users who prefer the desktop app. Runs locally — your API key stays on your machine.

Get Your API Key

Log in to LinkaGoGo
Click your avatar in the top-right corner and select Account
Scroll to API Keys and enter a name (e.g. "Claude Desktop")
Click Generate Key and copy the key — it starts with lgg_ and won't be shown again

Install Node.js

The MCP server requires Node.js version 18 or later. Download and install it if you don't have it already.

Verify with:

node --version

Configure Claude Desktop

Open your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

If the file doesn't exist, create it. Add the LinkaGoGo server:

{
  "mcpServers": {
    "linkagogo": {
      "command": "npx",
      "args": ["-y", "linkagogo-mcp"],
      "env": {
        "LINKAGOGO_API_TOKEN": "lgg_your_api_key_here"
      }
    }
  }
}

Replace lgg_your_api_key_here with your API key.

No download or build step needed — Claude Desktop installs the MCP server automatically via npx.

Restart Claude Desktop

Quit Claude Desktop completely (Cmd+Q on macOS, not just close the window), then reopen it.

You should see the hammer icon in the chat input area. Click it to verify LinkaGoGo's tools are listed.

Start Chatting

Ask Claude naturally:

"How many bookmarks do I have?"
"Search my bookmarks for Python tutorials"
"Add https://example.com to my Dev folder with tags 'reference' and 'docs'"
"What are my most visited bookmarks?"
"Show me my folder tree"
"Move all bookmarks tagged 'old' into an Archive folder"
"Export my Recipes folder as XBEL"
"What reminders are due?"

Cursor

Cursor supports MCP servers natively. Add LinkaGoGo to your Cursor settings:

Open Cursor and go to Settings > MCP
Click Add new MCP server
Set the type to command and enter:
```
npx -y linkagogo-mcp
```
Add the environment variable LINKAGOGO_API_TOKEN with your API key
Save and restart Cursor

VS Code + GitHub Copilot

GitHub Copilot in VS Code supports MCP servers. Add to your VS Code settings (settings.json):

{
  "mcp": {
    "servers": {
      "linkagogo": {
        "command": "npx",
        "args": ["-y", "linkagogo-mcp"],
        "env": {
          "LINKAGOGO_API_TOKEN": "lgg_your_api_key_here"
        }
      }
    }
  }
}

Then use Copilot Chat with the @linkagogo participant to manage your bookmarks.

Other MCP Clients

Any MCP-compatible client can connect to LinkaGoGo. There are two connection modes:

Local clients (stdio)

For clients that run MCP servers as local processes — use the same setup as Claude Desktop:

Command: npx -y linkagogo-mcp
Environment: LINKAGOGO_API_TOKEN=lgg_your_api_key_here

Compatible with: Windsurf (Codeium), Zed, Continue.dev, Cline, Claude Code, and others.

Remote clients (SSE/HTTP)

For clients that connect to a remote MCP server via HTTP — use the connector URL:

https://www.linkagogo.com/mcp

The client will handle OAuth authorization automatically.

Available Tools

Tool	What It Does
`search_bookmarks`	Search by keyword, filter by folder, sort by date/visits/rating
`add_bookmark`	Save a new bookmark (auto-fetches title if omitted)
`update_bookmark`	Update title, URL, keywords, rating, favorite, reminder
`delete_bookmark`	Delete a bookmark
`move_bookmarks`	Move bookmarks to a folder (bulk)
`tag_bookmarks`	Add or remove keyword tags (bulk)
`delete_bookmarks`	Delete multiple bookmarks (bulk)
`rate_bookmarks`	Set star rating 0–5 on bookmarks (bulk)
`favorite_bookmarks`	Set or unset favorite on bookmarks (bulk)
`set_reminder`	Set reminder schedule on bookmarks (bulk)
`list_folders`	Show folder tree or children of a folder
`create_folder`	Create a folder or a nested path (e.g. "Dev/Python/Libs")
`rename_folder`	Rename a folder
`move_folder`	Move a folder to a new parent
`delete_folder`	Delete a folder and its contents
`export_bookmarks`	Export as XBEL or Netscape HTML (full or by folder)
`import_bookmarks`	Import from XBEL or Netscape HTML
`get_stats`	Account statistics
`get_reminders`	Bookmarks with due reminders

Troubleshooting

Claude.ai (Web)

"Authorization failed" — Make sure you're logged in to LinkaGoGo in the same browser before approving. Try disconnecting and reconnecting the connector.
"Couldn't reach the MCP server" — The LinkaGoGo server may be temporarily unavailable. Try again in a moment.
Tools not available — Disconnect and reconnect the integration in Claude.ai Settings > Connectors to refresh the session.

Claude Desktop (App)

"LINKAGOGO_API_TOKEN environment variable is required" — Your API key is missing from the Claude Desktop config file.
Tools not showing up — Make sure you quit and reopened Claude Desktop (Cmd+Q, not just close the window). Check that node is in your PATH.
"Invalid API key" — Your key may have been revoked or mistyped. Generate a new one in Account > API Keys.

Both

"Rate limit exceeded" — Plus allows 5,000 requests/day; Premium allows 10,000/day. Wait until the next day or generate an additional key.
Need help? — Contact us at [email protected].

Updating

Claude.ai: No action needed — the server is always up to date.

Claude Desktop: The MCP server updates automatically via npx each time Claude Desktop starts.