LinkDrop
AboutConnectPricing
← All clients

MCP guide

How to connect Codex to LinkDrop

Two commands in a terminal: add the server, then log in.

Last updated: September 28, 2026

  1. Add LinkDrop to Codex

    Run this in a terminal. No key and no header. Codex stores the server in ~/.codex/config.toml.

    codex mcp add LinkDrop --url https://mcp.lnkdrp.com/mcp

    LinkDrop is just the name Codex lists this connection under. Change it to whatever you like, and use the same name in every step that mentions it.

  2. Sign in

    This opens LinkDrop in your browser. Sign in if you are not already, pick the workspace this agent should work in, and click Allow.

    codex mcp login LinkDrop

  3. 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.

  1. 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.

  2. Add LinkDrop to Codex

    Run this in a terminal. Codex stores the server in ~/.codex/config.toml.

    codex mcp add LinkDrop --url https://mcp.lnkdrp.com/mcp \  --header "Authorization: Bearer lnk_your_key_here"

    Replace lnk_your_key_here with your key.

  3. Check it registered

    Run codex mcp list and look for LinkDrop.

    codex mcp list

  4. 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 remove LinkDrop from Codex. To connect again, add it and log in.

codex mcp remove LinkDrop

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.

codex mcp add LinkDrop-Acme --url https://mcp.lnkdrp.com/mcpcodex mcp login LinkDrop-Acme

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.
I signed in but the agent says unauthorized.
It was revoked, or you signed in to another workspace. Remove LinkDrop, add it again and sign in.
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.

Open Agents →Other clientsCodex MCP docs