# Connect your AI app

> Add the LaunchDistro MCP server to Claude Code, Claude Desktop, Cursor, Codex or VS Code with one command or URL. Nothing to install.

Canonical: https://launchdistro.com/docs/setup
Last updated: 2026-10-31

[LaunchDistro](https://launchdistro.com/)

Documentation

LaunchDistro is a hosted MCP server: there is nothing to install. You add its address and a token made for your app, and your agent gets the tools.

## Four steps

1. to your dashboard. Every account starts on the Free plan.

2. Open in the dashboard, pick your app and choose _Create a key for_ that app. The token (`ld_agent_...`) is shown once, already filled into the command or config below, so copy it from there. Claude Desktop needs no key: it signs in instead.

3. **Add it to your app** with the command or config for that app (below). Restart the app if it asks.

4. **Check it is connected.** The Connect page flips to "connected" on your app's first call, and the title bar shows "Agent connected" with the time of the last call. Or ask your app: "Call LaunchDistro's license\_status."

## Your app's command

The snippets below use `<your-token>` in place of the token; the Connect page shows them with yours in.

Run this once in a terminal (or ask Claude Code to run it). It adds LaunchDistro for every project:

$claude mcp add --scope user --transport http launchdistro https://launchdistro.com/api/mcp --header "Authorization: Bearer \<your-token\>"

Nothing to installRuns in your own browserStops for sign-ins

## Notes per app

- **Claude Code.** The command adds the server for every project (`--scope user`). Use `claude mcp list` to see it and `claude mcp remove launchdistro` to take it off. Claude Code can run the command for you: paste it into the chat. Full guide: [Claude](https://launchdistro.com/integrations/claude).

- **Claude Desktop.** Open Customize, then Connectors, click _+_, choose _Add custom connector_ and paste the URL. Custom connectors work on Free (one connector), Pro, Max, Team and Enterprise; on Team and Enterprise an owner adds it first under Organization settings, then each member connects. You need no token here: the connector signs in to your LaunchDistro account with OAuth, and you approve it on a consent screen. Removing it from the Connect page ends its access at once.

- **Cursor.** Merge the entry into `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (one project) without removing servers already there. Cursor can read the token from an environment variable (`"Authorization": "Bearer ${env:LAUNCHDISTRO_TOKEN}"`) if you prefer not to keep it in the file. Guide: [Cursor](https://launchdistro.com/integrations/cursor).

- **Codex.** The Codex CLI, the IDE extension and the ChatGPT desktop app share `~/.codex/config.toml`. To keep the token out of the file, replace `http_headers` with `bearer_token_env_var = "LAUNCHDISTRO_TOKEN"` and set that variable. Guide: [Codex](https://launchdistro.com/integrations/codex).

- **VS Code.** The command adds it to your profile; use it in Agent mode in chat. You can also add it by hand to `.vscode/mcp.json` or your user `mcp.json` as a server with `"type": "http"`, a `url` and a `headers` entry. Guide: [VS Code](https://launchdistro.com/integrations/vscode).

- **A browser for the forms.** Your agent needs one to fill directory forms. Recommended: your own Chrome through Claude in Chrome, where you are already signed in to directories. Your app's built-in browser works too; it will ask which one to use.

## What to ask first

1. "Add my product from this repo to LaunchDistro." It reads the repository and your site, shows you the profile and saves it.

2. "Where does my product qualify?" (`match_directories`)

3. "Plan the run." (`plan_submissions`): the order and the reason for each, saved to the dashboard.

4. "Submit to the next 3 directories." It reads each playbook, asks you every decision at once, and fills the forms in your browser.

5. "What have I sent?" (`list_submissions`), and "check if any are live."

**Open your product's folder first.** In Claude Code or Cursor, start the agent inside the repository of the product you are launching, so it can read the README, the description and the stack for the profile. In apps with no file access (Claude Desktop, ChatGPT) the agent reads your live site and asks you for what it cannot find.

A badge or link back is added to your repository only if you say you will show one. The agent shows you the change, and committing and deploying stay with you.

The dashboard has a copyable prompt for each of these that already names your product and the next directory. There is also a `submit` prompt in apps that show MCP prompts.

## Tokens and seats

Each AI app has its own token, so one can be revoked without touching the others. Removing an app from the Connect page revokes its token at once. The plan sets how many apps can be connected: 1 on Free and on a Launch, 3 on Pro. The token is stored only as a hash; if you lose it, remove the app and create a new key. An app that signs in with OAuth, like Claude Desktop, takes a seat the same way.

## Any other client

Any app that connects to remote MCP servers works. Point it at the endpoint with the header:

| URL | `https://launchdistro.com/api/mcp` |
| --- | --- |
| Transport | Streamable HTTP |
| Header | `Authorization: Bearer <your-token>` |

To see it answer from a terminal, list the tools with one request:

```
curl -s https://launchdistro.com/api/mcp \
  -H "Authorization: Bearer <your-token>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
```

Responses are plain JSON: the server keeps no session between requests, so there is nothing to initialise or keep alive. The [tools reference](https://launchdistro.com/docs/tools) lists every tool's parameters.

## References

Each app documents its own MCP settings; these are the pages the steps above follow.

- [Claude Code: connect to MCP servers](https://code.claude.com/docs/en/mcp)

- [Claude: custom connectors using remote MCP](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp)

- [Cursor: Model Context Protocol](https://cursor.com/docs/context/mcp)

- [Codex: MCP servers](https://learn.chatgpt.com/docs/extend/mcp?surface=cli)

- [VS Code: add and manage MCP servers](https://code.visualstudio.com/docs/copilot/customization/mcp-servers)

- [MCP specification: transports](https://modelcontextprotocol.io/specification/latest/basic/transports)

## If it does not connect

- **"Unauthorized" or a 401.** The token is wrong, was revoked, or lost its `Bearer ` prefix. Create a new key on the Connect page.

- **The app says the endpoint is not found.** Check the address ends in `/api/mcp`, with no extra path.

- **Connected, but no tools.** Restart the app, or start a new chat: many apps read the tool list once per chat.

- **The Connect page still says "waiting".** It flips on the first tool call, not on adding the server. Ask your app to call `license_status`.

- **"Seats" or app limit reached.** Remove an app you no longer use from the Connect page, or move to Pro for 3 apps.

- **A tool answers with a limit.** Free plan used up, a Pro directory, a Launch that ended or a rate limit: the message names it and the way out. See [tool errors](https://launchdistro.com/docs/tools#errors).

## Your next 10 directory submissions are free.

Add it to Claude or Cursor, describe your product once, and watch the first form fill itself.

[LaunchDistro](https://launchdistro.com/)

LaunchDistro submits your startup to directories from Claude, Cursor and Codex. Your agent fills each form in your own browser, and we check every backlink went live.

Product

- [How it works](https://launchdistro.com/#loop)

- [Pricing](https://launchdistro.com/pricing)

Directories

- [All Directories](https://launchdistro.com/directories)

- [AI Search Directories (GEO)](https://launchdistro.com/directories/ai-directories)

- [Startup Launch Platforms](https://launchdistro.com/directories/launch-platforms)

- [Developer Ecosystems](https://launchdistro.com/directories/developer-ecosystems)

- [Startup Databases](https://launchdistro.com/directories/startup-databases)

- [How to get backlinks](https://launchdistro.com/guides/how-to-get-backlinks-with-ai)

- [Free web directories](https://launchdistro.com/blog/free-online-web-directories)

- [Blog](https://launchdistro.com/blog)

Integrations

- [Claude](https://launchdistro.com/integrations/claude)

- [Cursor](https://launchdistro.com/integrations/cursor)

- [Codex](https://launchdistro.com/integrations/codex)

- [VS Code](https://launchdistro.com/integrations/vscode)

- [MCP](https://launchdistro.com/mcp)

Compare

- [All services](https://launchdistro.com/alternatives/directory-submission-services)

- [vs ListingBott](https://launchdistro.com/vs/listingbott)

- [vs aidirectori.es](https://launchdistro.com/vs/aidirectories)

- [vs LaunchRepo](https://launchdistro.com/vs/launchrepo)

- [vs SubmitSaaS](https://launchdistro.com/vs/submitsaas)

- [vs Submitator](https://launchdistro.com/vs/submitator)

- [vs StartupSubmit](https://launchdistro.com/vs/startupsubmit)

Legal & Trust

- [Privacy Policy](https://launchdistro.com/privacy)

- [Terms of Service](https://launchdistro.com/terms)

- [Refund Policy](https://launchdistro.com/refund)

© 2026 LaunchDistro. Built with for founders, SaaS and startups.
