Add to Slashspace button

If you publish a remote MCP server, an Add to Slashspace link saves your users from copying URLs into settings. One click opens Slashspace on Settings > Connectors with your server's name and URL filled into Add a custom connector. Nothing is added, and Slashspace doesn't contact your server, until the user reviews it and clicks Add.

Link formats

Link	Use it when
https://www.slashspace.ai/mcp/add?name=...&url=...	Websites and READMEs. The landing page works whether or not the visitor has Slashspace.
slashspace://mcp/add?name=...&url=...	You know the user runs Slashspace 3.1.1 or later. Opens the app directly.

Both take the same two parameters:

Parameter	Value
name	Display name for the connector, up to 100 characters.
url	Your MCP endpoint as an absolute https:// URL, up to 2,048 characters. No username, password or #fragment.

Each must appear exactly once; any other parameter makes the link invalid. Build links with URLSearchParams so both values are percent-encoded:

const params = new URLSearchParams({
  name: "Acme",
  url: "https://mcp.acme.com/mcp",
});
const webLink = `https://www.slashspace.ai/mcp/add?${params}`;
const appLink = `slashspace://mcp/add?${params}`;

Add the button

HTML (note the & between parameters):

<a href="https://www.slashspace.ai/mcp/add?name=Acme&amp;url=https%3A%2F%2Fmcp.acme.com%2Fmcp">
  Add to Slashspace
</a>

Markdown:

[Add to Slashspace](https://www.slashspace.ai/mcp/add?name=Acme&url=https%3A%2F%2Fmcp.acme.com%2Fmcp)

Many Markdown renderers strip custom schemes like slashspace://, so use the https:// form there. There is no official badge image yet; style the link like your other buttons.

What your users see

1. The landing page shows "Add Acme to Slashspace", your server address and an Open Slashspace button (the browser may ask permission to open the app). Visitors without the app click Download Slashspace, install it, then return to the tab and click Open Slashspace.
2. Slashspace opens. If the user isn't signed in or doesn't have an active plan yet, they finish that first. The request waits as long as the app stays open.
3. The dialog appears on Settings > Connectors with the name and URL filled in. The user can edit either field or add headers.
4. The user clicks Add. Slashspace connects to your server and lists its tools, then shows "Connector added and checked." If your server needs sign-in, the dialog shows Connect your account with a Sign in button. If the connection fails, it shows "Could not connect" and offers Save anyway.

Cancel discards the request. A link never overwrites an existing connector: if the name is taken, the dialog says "A connector with this name already exists" and the user renames it. Repeat clicks on the same link give one request; links for different servers queue (up to 10).

Remote servers only

A link carries only a name and an HTTPS URL. Slashspace tries Streamable HTTP first, then SSE. Local (stdio) servers can't be installed by link: publish the command, arguments and environment variables so users can enter them under Runs on this computer (see Custom MCP connectors).

Authentication and secrets

Never put API keys, tokens or other secrets in the link, including your server URL's query string. Links end up in browser history, logs and screenshots, and every user would share one credential. Instead, use:

• OAuth. Answer unauthenticated requests with 401 and a WWW-Authenticate header, or publish /.well-known/oauth-protected-resource at your server's origin. Slashspace then offers Sign in and finishes in the user's browser. It uses dynamic client registration (a public client named "Slashspace") with PKCE and redirects to http://127.0.0.1:<port>/connectors/oauth/callback. The port can change, so accept loopback redirects on any port.
• Headers. Tell users which header to set (for example Authorization). They add it with Add header before clicking Add.

Test your link

1. Open the https:// link in a browser. "This connector link is incomplete or invalid" means a parameter is missing, repeated, not HTTPS or too long.
2. Click Open Slashspace and check the dialog shows your name and URL exactly.
3. Click Add, confirm the connector appears under Your connections, then remove it from its ⋯ menu.

To try the app link without the landing page:

# macOS
open "slashspace://mcp/add?name=Acme&url=https%3A%2F%2Fmcp.acme.com%2Fmcp"
# Linux
xdg-open "slashspace://mcp/add?name=Acme&url=https%3A%2F%2Fmcp.acme.com%2Fmcp"
# Windows (PowerShell)
Start-Process "slashspace://mcp/add?name=Acme&url=https%3A%2F%2Fmcp.acme.com%2Fmcp"

An invalid app link shows a "Cannot add connector" error. If Slashspace opens with no dialog, it's older than 3.1.1 and needs an update.

Related

• Custom MCP connectors: adding a server by hand.
• Connectors: managing connectors.
• Agent mode and tools: how chats use connector tools.