MCP guide
How to connect Cursor to LinkDrop
A few lines in Cursor's mcp.json, then click Login. Works globally or per project.
Last updated: September 28, 2026
Open Cursor's MCP settings
Open Cursor Settings, then MCP, then Add new global MCP server. This opens ~/.cursor/mcp.json. Use .cursor/mcp.json inside a project to scope the server to that project.
Add the LinkDrop server
Paste this if the file is empty, then save. No key and no header.
{ "mcpServers": { "LinkDrop": { "url": "https://mcp.lnkdrp.com/mcp" } }}LinkDropis just the name Cursor lists this connection under. Change it to whatever you like, and use the same name in every step that mentions it.Sign in
Back in Cursor's MCP settings, LinkDrop shows Needs login. Click it: LinkDrop opens in your browser, you pick the workspace this agent should work in and click Allow. Cursor then shows a green dot next to LinkDrop.
Verify
Ask your agent: “Which LinkDrop workspace are you connected to?”
Back on Agents, the agent is listed as Signed in, and the status turns to Connected on its first call. Revoke it there at any time.
Using a key instead
For a script, a server, or a machine with no browser. A key does everything signing in does; it just has to be pasted, and kept.
Create a key
Sign in and open Agents, then create a key named for this machine. It is shown once, so copy it right away. Keys start with
lnk_and belong to one workspace.Open Cursor's MCP settings
Open Cursor Settings, then MCP, then Add new global MCP server. This opens ~/.cursor/mcp.json. Use .cursor/mcp.json inside a project to scope the server to that project.
Add the LinkDrop server
Paste this if the file is empty. Save, and Cursor shows a green dot next to LinkDrop once it connects.
{ "mcpServers": { "LinkDrop": { "url": "https://mcp.lnkdrp.com/mcp", "headers": { "Authorization": "Bearer lnk_your_key_here" } } }}If you already have other servers, add only this entry inside your existing
mcpServersobject:"LinkDrop": { "url": "https://mcp.lnkdrp.com/mcp", "headers": { "Authorization": "Bearer lnk_your_key_here" }}Replace
lnk_your_key_herewith your key.Verify the key
Check the key itself from a terminal:
curl -s https://www.lnkdrp.com/api/agent/whoami \ -H "Authorization: Bearer lnk_your_key_here" \ -H "x-lnkdrp-agent: curl/1"
Disconnect or reconnect
To disconnect, revoke the agent on the Agents page and delete the "LinkDrop" entry from mcp.json. To connect again, add the entry and click Login.
More than one workspace
A connection belongs to one workspace, and your client keeps one server per name. To connect another workspace, add LinkDrop again under a different name, any name you will recognize, such as LinkDrop Acme (LinkDrop-Acme in a command), and pick that workspace when you sign in, or use a key created there. Existing connections keep working, and your agent sees them all; lnkdrp_whoami on each says which workspace it acts on.
{ "mcpServers": { "LinkDrop-Acme": { "url": "https://mcp.lnkdrp.com/mcp" } }}Pick that workspace when you sign in. Any name works, as long as each workspace has its own.
Troubleshooting
- My client never opened the sign-in page.
- Look for Authenticate, Login or /mcp auth next to LinkDrop in your client. No such option? Use an API key instead.
- My client says LinkDrop already exists.
- Changing the key? Remove the old entry, then add it again. Another workspace? Add it under a different name, such as LinkDrop-Acme.
- I get 401 unauthorized.
- The key was revoked or pasted with a stray space. Create a new one; revoking the old one is safe.
- The agent sees the wrong workspace.
- Each connection is tied to one workspace. Add LinkDrop again under a name of its own, such as LinkDrop-Acme, for that workspace.
- How does LinkDrop know which client connected?
- Your agent's app tells LinkDrop its name when it connects.
- Can I have more than one key?
- Yes, up to 10. One per agent lets you revoke one without touching the rest.
Still stuck? Connect your agent walks through it in full, and How LinkDrop Works covers the rest.