Skip to main content

Setup

The ABsmartly MCP server can be added to any MCP-compatible client. This page covers Claude Desktop, Claude Code, Cursor, Windsurf, VS Code (Copilot), Gemini (CLI, Code Assist and Enterprise), ChatGPT, Goose, GitHub Copilot CLI, cloud agent platforms and the DXT extension.

For details on API keys and supported Authorization header formats, see Authentication. For how OAuth clients are registered and which ones are accepted, see OAuth & Client Registration.

Transports​

The server is reachable on two HTTP endpoints:

EndpointTransportNotes
https://mcp.absmartly.com/mcpStreamable HTTPModern MCP transport (recommended for new installs).
https://mcp.absmartly.com/sseSSELegacy transport. Still works; required by some older clients.

The MCP spec deprecated SSE in March 2025, but /sse continues to be supported for compatibility.

Your instance's own /mcp endpoint​

Your ABsmartly instance also serves MCP directly:

https://your-instance.absmartly.com/mcp

It uses Streamable HTTP only (there is no /sse endpoint), and accepts OAuth through your instance's own login, or an API key sent as Authorization: Api-Key YOUR_API_KEY. Because the URL already identifies your instance, no absmartly-endpoint parameter or x-absmartly-endpoint header is needed. Use this URL in place of https://mcp.absmartly.com/mcp in any of the Streamable HTTP examples below. See OAuth & Client Registration for how the two differ.

Availability

The instance /mcp endpoint ships with ABsmartly platform release v2026-09.24 and later. If https://your-instance.absmartly.com/mcp returns 404, your instance hasn't been updated yet: use the hosted server, and ask ABsmartly support when your instance will be upgraded.

Local stdio​

You can also run the server locally over stdio with npx @absmartly/mcp, which reuses your ABsmartly CLI config and macOS Keychain credentials.


Claude Desktop​

Open Settings → Connectors, scroll to the bottom, and click Add custom connector.

Claude Desktop Connectors settings

In the dialog, give the connector a name (e.g. ABsmartly) and paste the URL into Remote MCP server URL:

Add custom connector dialog

URL:

https://mcp.absmartly.com/mcp?absmartly-endpoint=https://your-instance.absmartly.com

Click Add, then Connect. Claude Desktop will open your browser. Approve the consent page, then sign in to ABsmartly (SAML/credentials). After authentication, the MCP connection is established automatically.

You can also use your instance's own endpoint, https://your-instance.absmartly.com/mcp, as the URL.

tip

The absmartly-endpoint query parameter is optional. If omitted, the OAuth flow will prompt you to enter the URL of your ABsmartly instance in the browser before login:

Connect to ABsmartly endpoint prompt


Claude Code​

claude mcp add --transport sse --scope user absmartly \
https://mcp.absmartly.com/sse \
-H "Authorization:YOUR_API_KEY" \
-H "x-absmartly-endpoint:https://your-instance.absmartly.com"

Subdomain shorthand — auto-constructs https://<subdomain>.absmartly.com/v1:

claude mcp add --transport sse --scope user absmartly \
https://mcp.absmartly.com/sse \
-H "Authorization:my-subdomain YOUR_API_KEY"

Cursor​

One-click install (OAuth): . Cursor will prompt you for the ABsmartly instance URL in the browser, then the flow completes automatically.

Or configure manually in .cursor/mcp.json (project) or ~/.cursor/mcp.json (global):

{
"mcpServers": {
"absmartly": {
"url": "https://mcp.absmartly.com/sse",
"headers": {
"Authorization": "YOUR_API_KEY",
"x-absmartly-endpoint": "https://your-instance.absmartly.com"
}
}
}
}

Windsurf​

Configure ~/.codeium/windsurf/mcp_config.json:

note

Windsurf uses "serverUrl" (not "url").

{
"mcpServers": {
"absmartly": {
"serverUrl": "https://mcp.absmartly.com/sse",
"headers": {
"Authorization": "YOUR_API_KEY",
"x-absmartly-endpoint": "https://your-instance.absmartly.com"
}
}
}
}

VS Code (GitHub Copilot)​

One-click install (OAuth): . You'll be prompted for your ABsmartly instance URL in the browser.

Or configure manually in .vscode/mcp.json (workspace) or via Command Palette → MCP: Open User Configuration.

note

VS Code uses "servers" as the root key (not "mcpServers").

{
"servers": {
"absmartly": {
"type": "sse",
"url": "https://mcp.absmartly.com/sse",
"headers": {
"Authorization": "${input:absmartly-api-key}",
"x-absmartly-endpoint": "https://your-instance.absmartly.com"
}
}
},
"inputs": [
{
"type": "promptString",
"id": "absmartly-api-key",
"description": "ABsmartly API Key",
"password": true
}
]
}
caution

MCP tools only appear in Agent mode in VS Code, not in Ask or Edit mode.


Gemini (CLI + Code Assist)​

Works for Gemini CLI (terminal) and Gemini Code Assist (VS Code, JetBrains, Android Studio agent mode). Both read ~/.gemini/settings.json (user-wide) or .gemini/settings.json (per-project). JetBrains IDEs use mcp.json instead.

{
"mcpServers": {
"absmartly": {
"url": "https://mcp.absmartly.com/sse?absmartly-endpoint=https://your-instance.absmartly.com"
}
}
}

Gemini auto-discovers the OAuth requirement. In Gemini CLI, run /mcp auth absmartly when prompted; in Code Assist agent mode the browser opens automatically.

Gemini Enterprise (Google Cloud Console)​

Gemini Enterprise's Custom MCP Server connector (Preview) requires Streamable HTTP transport — use the /mcp endpoint:

  1. Google Cloud Console → Gemini Enterprise → Data stores → Create data store.
  2. Search "Custom MCP Server" → Add MCP server.
  3. Server URL: https://mcp.absmartly.com/mcp?absmartly-endpoint=https://your-instance.absmartly.com
  4. Authentication: OAuth. The connector form asks for an existing OAuth client. First register a client manually with the redirect URI https://vertexaisearch.cloud.google.com/oauth-redirect, then enter its client_id and client_secret, the authorization and token URLs from the endpoint table, and the mcp:access scope. Select Enable PKCE Support: ABsmartly requires PKCE with S256. Keep Use HTTP Basic Authentication selected, to match the client_secret_basic method in the registration example.
  5. Save and wait for the connector status to become Active.

When you first authorize, the consent page shows a warning that the Google callback is shared by all Gemini Enterprise customers. Approve only if you just started the connection yourself.

caution

SSE transport (/sse) is not supported by this connector. The Gemini CLI / Code Assist sections above continue to use /sse until those clients add Streamable HTTP support.

Reload the IDE window after editing settings (VS Code: Command Palette → Developer: Reload Window). MCP support in Code Assist requires agent preview mode — set "geminicodeassist.updateChannel": "Insiders" in VS Code settings if not already enabled.


ChatGPT (Developer Mode)​

ChatGPT does not support one-click install deeplinks — you connect remote MCP servers via the Custom Connectors UI. Requires a Pro, Team, Enterprise or Edu plan, and Developer Mode enabled (Settings → Connectors → Advanced → Developer mode).

  1. Go to Settings → Connectors → Create.
  2. Fill in:
    • Name: ABsmartly
    • MCP Server URL: https://mcp.absmartly.com/mcp?absmartly-endpoint=https://your-instance.absmartly.com
    • Authentication: OAuth (ChatGPT registers itself automatically through dynamic client registration)
  3. Save. In a new chat, click + → Developer mode → select the ABsmartly connector to add it as a tool source.
note

Workspace admins must first enable Custom MCP connectors in Workspace Settings → Permissions & Roles → Connected Data.


Goose​

Goose identifies itself with a trusted client metadata document, so no registration step is needed. Run goose configure (or open Extensions in Goose Desktop), choose Add Extension → Remote Extension (Streamable HTTP), skip custom headers, and use the URL:

https://mcp.absmartly.com/mcp?absmartly-endpoint=https://your-instance.absmartly.com

Goose opens your browser to sign in the first time it connects.


GitHub Copilot CLI​

GitHub Copilot CLI also uses a trusted client metadata document. Add the server from the terminal:

copilot mcp add --transport http absmartly \
"https://mcp.absmartly.com/mcp?absmartly-endpoint=https://your-instance.absmartly.com"

Or add it to ~/.copilot/mcp-config.json:

{
"mcpServers": {
"absmartly": {
"type": "http",
"url": "https://mcp.absmartly.com/mcp?absmartly-endpoint=https://your-instance.absmartly.com",
"tools": ["*"]
}
}
}

Copilot CLI opens your browser to sign in the first time it uses the server.


Cloud agent platforms​

Hosted agent platforms connect to the MCP server from their own cloud. Point them at the hosted Streamable HTTP endpoint and choose OAuth:

https://mcp.absmartly.com/mcp?absmartly-endpoint=https://your-instance.absmartly.com

Gemini Enterprise is covered above. Other platforms whose callbacks are on the allowlist may work, but we haven't tested them yet, so they have no setup guide here. ABsmartly requires the authorization-code flow with PKCE (S256). If a platform asks you for a client ID and secret instead of registering itself, see Manual registration. If it can't connect, use an API key.

These platforms use callback URLs shared by all their customers, so the consent page shows an extra warning.


Other clients​

Any MCP client that supports OAuth with dynamic client registration or a trusted client metadata document, and uses an allowed redirect URI, works with the same URL as above. Local clients that sign in through a localhost callback, such as Zed, Kiro, OpenCode or MCP Inspector, are accepted automatically.

If your client is rejected, connect with an API key instead, or see Your client isn't on the list?.


DXT Extension​

  1. Download from mcp.absmartly.com/absmartly-mcp.dxt.
  2. Double-click to install in Claude Desktop.
  3. Enter your ABsmartly endpoint when prompted.