# Get an Embedded MCP connect URL

Create a single-use Embedded MCP link so an end user can connect or repair an app account.

`get-connect-url` creates a link where the end user can connect an app. Pass `connectionId` to repair an existing connection. This tool requires a Full Access key.

```json
{
  "appRef": "slack"
}
```

```json
{
  "success": true,
  "data": {
    "url": "https://app.mindcloud.co/embedded-install#t=example-token",
    "appName": "Slack",
    "expiresAt": "2026-09-28T12:15:00.000Z",
    "singleUse": true
  }
}
```

Show `data.url` exactly as returned, and only to the same signed-in user. Whoever opens the link can connect an account as that end user. The link works once and expires after 15 minutes. The new account appears in [`list-connections`](/docs/embedded/embedded-mcp/tool-calls/list-connections) after connection.

To repair an invalid account, use its `connectionId` from `list-connections` or the `CONNECTION_INVALID` error:

```json
{
  "appRef": "slack",
  "connectionId": "cred_public_1"
}
```

The tool permits at most 10 links per minute for one end user. Issue a new link only when the user needs it; an expired or used link cannot be reused.