← MinSets

Install MinSets

Two surfaces, one substrate. ~2 minutes.

Before you install — the 60-second version of how your data is handled

Content you save is stored in plaintext on a single hosted server operated by Fo0l1sh. The operator has technical access for system maintenance and your own support requests — not for browsing, training AI, embeddings, or sharing with third parties. Never.

When you use the Claude.ai chat connector, the bodies of MCP tool calls also pass through Anthropic's backend on the way to MinSets — true of every claude.ai MCP server, not specific to MinSets. Claude Code & Desktop connect directly from your machine; nothing routes through Anthropic.

Full picture: Privacy Policy · Terms. If those terms don't work for what you want to save, V1 isn't the right tool yet — see the privacy policy for the end-to-end-encryption roadmap.

Step 1 — Get your token

Sign in with GitHub

After sign-in you land on your settings page with a one-time token. Copy it immediately — it's shown once. If you lose it, regenerate (the old one stops working).

Step 2 — Add MinSets to Claude Code

Edit ~/.claude/mcp_servers.json (Windows: %USERPROFILE%\.claude\mcp_servers.json):
{
  "mcpServers": {
    "minsets": {
      "url": "https://api.minsets.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}
Replace YOUR_TOKEN_HERE with the token from Step 1. If the file already has other MCP servers, add the "minsets" block alongside them — don't replace the whole file. Restart Claude Code after saving.

Step 3 — Add MinSets to Claude.ai chat

Different from Step 2 — claude.ai handles auth via a popup, no token paste.
  1. In claude.ai → Customize → Connectors → click the + button.
  2. Paste the URL: https://api.minsets.com/mcp
  3. Click Add / Connect. The connector appears in the list.
  4. Look for an Authenticate / Sign in button on the connector card. (If claude.ai doesn't show one upfront, it will pop up the first time Claude tries to use a minsets tool in a chat.)
  5. Click it. A window opens to https://api.minsets.com/authorize. If you're not already signed in to MinSets, you'll bounce through GitHub login first.
  6. You'll see a consent page asking "Claude.ai is requesting access to your MinSets — Allow?" Click Allow.
  7. The window closes / you bounce back to claude.ai. Connector is now fully connected.
You never paste a token here. claude.ai and MinSets exchange it server-to-server via OAuth — the token never crosses your screen, never lands in chat history. To revoke this connection later, sign in to /settings and use the per-app Revoke button.
This is the half that makes MinSets cross-surface: what you save in Claude Code becomes recallable here, and vice versa.

Step 4 — Test it

In Claude Code:

Save "my first minset works" as test/first using minsets

Then in a new Claude Code chat (or in Claude.ai if you wired Step 3):

Recall what I saved as test/first using minsets

You should get back the exact string you saved.

Troubleshooting

"Invalid or revoked token" (Claude Code / Desktop)

Your token is wrong, expired, or was regenerated. Get a fresh one at /settings and update mcp_servers.json. Restart the client after.

"Authorization required" (Claude Code / Desktop)

The Authorization header isn't reaching the server. Check the headers block in your config matches the snippet exactly, including Bearer + a space before the token. This error does NOT apply to claude.ai — claude.ai uses OAuth, not header pasting.

claude.ai connector shows tools but tool calls fail with auth error

claude.ai cached "no-auth-required" from before OAuth was enabled on your server. Fix: Disconnect the minsets connector in claude.ai, then re-add it with the same URL. claude.ai will re-probe and discover OAuth, and an Authenticate button will appear.

claude.ai connector has no Authenticate button

Some versions of claude.ai trigger the OAuth flow only when Claude actually tries to call a tool. Just ask Claude to use a minsets tool in a chat — the popup will appear at that point.

Claude doesn't see the minsets tools

Claude Code: restart it fully (quit, not just close). Confirm the JSON is valid (no trailing commas). The server name (minsets) is what you reference in prompts. Claude.ai: refresh the page after the connector is added + authenticated.

Saved in one surface, can't recall in the other

Both surfaces must be authenticated to the same MinSets account (same GitHub login). Different accounts = different isolated workspaces.

MinSets · Install · Privacy · Terms · Source