> For the complete documentation index, see [llms.txt](https://docs.platform.softwareone.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.platform.softwareone.com/developer-resources/mcp-server/mcp-server-setup.md).

# MCP server setup

This topic explains how to configure popular AI clients to connect to the SoftwareOne Model Context Protocol (MCP) Server.

Once connected, your AI assistant can query the marketplace, read documentation, and perform actions on your behalf.

### Prerequisites

Before you begin, ensure you have the following:

* **SoftwareOne API Token** - You can generate this in the [SoftwareOne Marketplace Platform](https://portal.platform.softwareone.com/).
* **Configuration details** - See [Marketplace MCP Server README](/developer-resources/mcp-server.md#client-setup) for the exact JSON configuration blocks.

### Claude Desktop

[Claude Desktop](https://claude.ai/download) provides a native integration for MCP servers.

1. **Locate the config file** - Open your configuration file. If it doesn't exist, create it.
   1. **macOS** - `~/Library/Application Support/Claude/claude_desktop_config.json`
   2. **Windows** -  `%APPDATA%\Claude\claude_desktop_config.json`
2. **Configure server** - Copy the appropriate configuration block (Remote or Local) from the [Marketplace MCP Server README](/developer-resources/mcp-server.md#client-setup) and add it to the `mcpServers` object in your config file.
3. **Restart Claude** - Completely quit and restart the Claude Desktop application. You should see a plug icon indicating the server is connected.

### Cursor

[Cursor](https://cursor.com) is an AI-powered code editor that supports MCP.

1. **Open Settings** - Open Cursor. Go to **Cursor Settings** > **General** > **MCP**.
2. **Add New Server** - Select **+ Add New MCP Server**.
   1. **Name** - Enter `softwareone-marketplace`.
   2. **Type** - Select `stdio` (for local) or `sse` (for remote).
   3. Follow the configuration patterns provided in the [Marketplace MCP Server README](/developer-resources/mcp-server.md#client-setup).
3. **Verify** - Once added, the status indicator should turn green.

### Antigravity

[Antigravity ](https://antigravity.google/)(and compatible Google Cloud-based agents) supports MCP servers defined in the project configuration.

1. **Project configuration** - Add the server definition to your `.agent/mcp_servers_config.json` (or similar). You can find the required JSON structure in the [Marketplace MCP Server README](/developer-resources/mcp-server.md#client-setup).
2. Validation - Ask the agent to "*List available MCP resources*" to verify the connection.

### Generic / Custom Agents

If you are building your own agent or using another tool, you can connect via standard input/output (stdio) or Server-Sent Events (SSE).

### Usage

See the [Usage Section in the README](/developer-resources/mcp-server.md#other-clients) for endpoint details and header requirements.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.platform.softwareone.com/developer-resources/mcp-server/mcp-server-setup.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.