Connect AI assistants

Connect an assistant

You never paste a password or an API key. The assistant sends you to Pinport, you sign in and approve the connection, and you are sent back.

Claude

1. In Claude, open Customize → Connectors.
2. Choose Add custom connector and enter the address above.
3. Select Connect, sign in to Pinport and approve.

The connector then works in Claude on the web, on desktop and on mobile.

Claude Code

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

Then run /mcp in Claude Code and authenticate the pinport server.

Other apps

Any app that supports remote MCP servers with OAuth can connect: add a server of the type HTTP (also called Streamable HTTP) with the address above. Apps configured through a JSON file usually expect an entry like this one:

{
    "mcpServers": {
        "pinport": {
            "type": "http",
            "url": "https://pinport.app/mcp"
        }
    }
}

What a connected assistant can do

• Search your bookmarks by meaning, including the content of the pages you saved, or by exact words.
• List bookmarks by tag or by the date you saved them, including untagged bookmarks and bookmarks whose page is gone or has moved.
• Read a bookmark with its note and tags, and the list of your tags.
• Save a page with a note and tags. A page you have already saved is not saved twice.
• Edit the title, note, tags or address of a bookmark.
• Delete a bookmark.

Most assistants ask for your confirmation before they change or delete something; how they ask is up to the assistant. An assistant cannot import files, edit many bookmarks at once, rename tags, or touch your account, API keys, webhooks and billing.

Things to ask

• “What did I save about database indexing?”
• “Find the article on sleep I bookmarked last spring and summarize why I saved it.”
• “Save this page to Pinport, tagged recipes, with a note that it needs a Dutch oven.”
• “Which of my bookmarks are dead links?”
• “List my untagged bookmarks from this month and suggest tags from the ones I already use.”

Access and privacy

A connection gives one app access to the bookmarks of one account: addresses, titles, your notes and tags, and short excerpts of saved pages in search results. The approval screen names the app, shows where you will be sent back to, and says whether the app may change bookmarks or only read them.

What an assistant reads from Pinport becomes part of your conversation with it and is handled under that assistant’s terms. Pinport sends your bookmarks only in answer to the assistant’s requests and receives nothing from your conversation beyond those requests, such as a search query or the page you ask it to save.

See and remove connections

Settings → Integrations lists every connected app with the date you connected it and when it was last active. Removing a connection there takes effect immediately. Removing the connector inside the assistant ends the connection as well. A connection that has not been used for 30 days ends by itself.

If something does not work

• The assistant says a subscription is required. The connection is fine, but the account has no active plan. See pricing.
• The assistant asks you to connect again. The connection was removed or has expired. Connect again; nothing is lost.
• A search finds nothing. Ask the assistant to search for the exact words instead of the topic, or the other way round. Newly saved pages become searchable by their content a little after they are saved.
• Requests are refused for a minute. The connected apps of an account share a limit of 120 requests per minute.

Anything else: contact support.

For developers

• Transport: Streamable HTTP at https://pinport.app/mcp, stateless. Protocol revision 2026-07-28 and the 2025 revisions are served.
• Authorization: OAuth 2.1 authorization code with PKCE (S256) for public clients, with rotating refresh tokens. Discovery starts at the WWW-Authenticate header of the 401 response, or at https://pinport.app/.well-known/oauth-protected-resource/mcp.
• Client registration: Client ID Metadata Documents, or dynamic client registration (RFC 7591).
• Scopes: bookmarks:read and bookmarks:write. A token without bookmarks:write is not offered the tools that change bookmarks.
• Tools: search_bookmarks, list_bookmarks, get_bookmark, list_tags, save_bookmark, update_bookmark, delete_bookmark. Every tool declares an output schema and returns structured content.

For scripts and automation platforms, the API and webhooks are the better fit.