diff --git a/apps/web/src/lib/developer-config.ts b/apps/web/src/lib/developer-config.ts index c816de08..80e74b36 100644 --- a/apps/web/src/lib/developer-config.ts +++ b/apps/web/src/lib/developer-config.ts @@ -215,7 +215,9 @@ export function getCodeForMCPClientConfig({ } case 'cursor': { - const config = Buffer.from(JSON.stringify(mcpConfig)).toString('base64') + const config = Buffer.from(JSON.stringify({ url: mcpUrl })).toString( + 'base64' + ) const href = `cursor://anysphere.cursor-deeplink/mcp/install?name=${identifier}&config=${config}` return { diff --git a/docs/docs.json b/docs/docs.json index 7196f3a1..2f691d36 100644 --- a/docs/docs.json +++ b/docs/docs.json @@ -57,6 +57,20 @@ "marketplace/ts-sdks/genkit", "marketplace/ts-sdks/mastra" ] + }, + { + "group": "MCP Clients", + "pages": [ + "marketplace/mcp-clients/claude-code", + "marketplace/mcp-clients/claude-desktop", + "marketplace/mcp-clients/cline", + "marketplace/mcp-clients/cursor", + "marketplace/mcp-clients/raycast", + "marketplace/mcp-clients/trae", + "marketplace/mcp-clients/vscode", + "marketplace/mcp-clients/warp", + "marketplace/mcp-clients/windsurf" + ] } ] }, diff --git a/docs/marketplace/index.mdx b/docs/marketplace/index.mdx index c226a564..446be9e8 100644 --- a/docs/marketplace/index.mdx +++ b/docs/marketplace/index.mdx @@ -184,7 +184,80 @@ description: A quick start on how to use tools from Agentic's marketplace. ## MCP Clients -_MCP client docs are coming soon..._ + + + How to use Agentic tools with Cursor. + + + + How to use Agentic tools with Claude Code. + + + + How to use Agentic tools with Claude Desktop. + + + + How to use Agentic tools with Cline. + + + + How to use Agentic tools with Raycast. + + + + How to use Agentic tools with Trae. + + + + How to use Agentic tools with VS Code. + + + + How to use Agentic tools with Warp. + + + + How to use Agentic tools with Windsurf. + + + ## Python AI SDKs diff --git a/docs/marketplace/mcp-clients/claude-code.mdx b/docs/marketplace/mcp-clients/claude-code.mdx new file mode 100644 index 00000000..b2619350 --- /dev/null +++ b/docs/marketplace/mcp-clients/claude-code.mdx @@ -0,0 +1,12 @@ +--- +title: Claude Code +description: How to use Agentic tools with Claude Code as an MCP client. +--- + +See [Claude Code MCP docs](https://docs.anthropic.com/en/docs/claude-code/mcp) for more info. + +## Example + +```sh +claude mcp add --transport http "@agentic/search" "https://gateway.agentic.so/@agentic/search/mcp" +``` diff --git a/docs/marketplace/mcp-clients/claude-desktop.mdx b/docs/marketplace/mcp-clients/claude-desktop.mdx new file mode 100644 index 00000000..45763c30 --- /dev/null +++ b/docs/marketplace/mcp-clients/claude-desktop.mdx @@ -0,0 +1,27 @@ +--- +title: Claude Desktop +description: How to use Agentic tools with Claude Desktop as an MCP client. +--- + +Claude Desktop requires you to use [mcp-remote](https://github.com/geelen/mcp-remote) because it currently only supports local `stdio` MCP servers. + +## Example + +```json +{ + "mcpServers": { + "@agentic/search": { + "command": "npx", + "args": [ + "-y", + "mcp-remote", + "https://gateway.agentic.so/@agentic/search/mcp" + ] + } + } +} +``` + +## DXT + +Agentic tools don't currently support Anthropic's [Desktop Extensions (DXT)](https://www.anthropic.com/engineering/desktop-extensions) format. diff --git a/docs/marketplace/mcp-clients/cline.mdx b/docs/marketplace/mcp-clients/cline.mdx new file mode 100644 index 00000000..127c44d3 --- /dev/null +++ b/docs/marketplace/mcp-clients/cline.mdx @@ -0,0 +1,19 @@ +--- +title: Cline +description: How to use Agentic tools with Cline as an MCP client. +--- + +## Example + +```json +{ + "mcpServers": { + "@agentic/search": { + "url": "https://gateway.agentic.so/@agentic/search/mcp", + "disabled": false + } + } +} +``` + +See the [Cline MCP docs](https://docs.cline.bot/mcp/connecting-to-a-remote-server) for more details. diff --git a/docs/marketplace/mcp-clients/cursor.mdx b/docs/marketplace/mcp-clients/cursor.mdx new file mode 100644 index 00000000..a0c14f41 --- /dev/null +++ b/docs/marketplace/mcp-clients/cursor.mdx @@ -0,0 +1,20 @@ +--- +title: Cursor +description: How to use Agentic tools with Cursor as an MCP client. +--- + +Go to: `Settings` -> `Cursor Settings` -> `MCP` -> `Add new global MCP server` + +Pasting the following configuration into your Cursor `~/.cursor/mcp.json` file is the recommended approach. You may also install in a specific project by creating `.cursor/mcp.json` in your project folder. See [Cursor MCP docs](https://docs.cursor.com/context/model-context-protocol) for more info. + +## Example + +```json +{ + "mcpServers": { + "@agentic/search": { + "url": "https://gateway.agentic.so/@agentic/search/mcp" + } + } +} +``` diff --git a/docs/marketplace/mcp-clients/raycast.mdx b/docs/marketplace/mcp-clients/raycast.mdx new file mode 100644 index 00000000..45fa4012 --- /dev/null +++ b/docs/marketplace/mcp-clients/raycast.mdx @@ -0,0 +1,28 @@ +--- +title: Raycast +description: How to use Agentic tools with Raycast as an MCP client. +--- + +## Example + +```json +{ + "mcpServers": { + "@agentic/search": { + "url": "https://gateway.agentic.so/@agentic/search/mcp" + } + } +} +``` + +## Raycast Deep Link + + + Raycast Deep Link + + +See the [Raycast MCP docs](https://manual.raycast.com/model-context-protocol) for more details. diff --git a/docs/marketplace/mcp-clients/trae.mdx b/docs/marketplace/mcp-clients/trae.mdx new file mode 100644 index 00000000..2aea05bd --- /dev/null +++ b/docs/marketplace/mcp-clients/trae.mdx @@ -0,0 +1,20 @@ +--- +title: Trae +description: How to use Agentic tools with Trae as an MCP client. +--- + +Use the Add manually feature and fill in the JSON configuration information for that MCP server. + +For more details, visit the [Trae documentation](https://docs.trae.ai/ide/model-context-protocol?_lang=en). + +## Example + +```json +{ + "mcpServers": { + "@agentic/search": { + "url": "https://gateway.agentic.so/@agentic/search/mcp" + } + } +} +``` diff --git a/docs/marketplace/mcp-clients/vscode.mdx b/docs/marketplace/mcp-clients/vscode.mdx new file mode 100644 index 00000000..fc3ff5f0 --- /dev/null +++ b/docs/marketplace/mcp-clients/vscode.mdx @@ -0,0 +1,19 @@ +--- +title: VS Code +description: How to use Agentic tools with VS Code as an MCP client. +--- + +Add the given JSON to your VS Code MCP config file. See [VS Code MCP docs](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) for more info. + +## Example + +```json +"mcp": { + "servers": { + "@agentic/search": { + "type": "http", + "url": "https://gateway.agentic.so/@agentic/search/mcp" + } + } +} +``` diff --git a/docs/marketplace/mcp-clients/warp.mdx b/docs/marketplace/mcp-clients/warp.mdx new file mode 100644 index 00000000..113640f7 --- /dev/null +++ b/docs/marketplace/mcp-clients/warp.mdx @@ -0,0 +1,18 @@ +--- +title: Warp +description: How to use Agentic tools with Warp as an MCP client. +--- + +## Example + +```json +{ + "mcpServers": { + "@agentic/search": { + "url": "https://gateway.agentic.so/@agentic/search/mcp" + } + } +} +``` + +See the [Warp MCP docs](https://docs.warp.dev/knowledge-and-collaboration/mcp#adding-an-mcp-server) for more details. diff --git a/docs/marketplace/mcp-clients/windsurf.mdx b/docs/marketplace/mcp-clients/windsurf.mdx new file mode 100644 index 00000000..3a32a2ed --- /dev/null +++ b/docs/marketplace/mcp-clients/windsurf.mdx @@ -0,0 +1,23 @@ +--- +title: Windsurf +description: How to use Agentic tools with Windsurf as an MCP client. +--- + +Windsurf requires you to use [mcp-remote](https://github.com/geelen/mcp-remote) because [they do not support the Streamable HTTP Transport](https://docs.windsurf.com/windsurf/cascade/mcp). + +## Example + +```json +{ + "mcpServers": { + "@agentic/search": { + "command": "npx", + "args": [ + "-y", + "mcp-remote", + "https://gateway.agentic.so/@agentic/search/mcp" + ] + } + } +} +``` diff --git a/docs/media/mcp-clients/raycast-screenshot.jpg b/docs/media/mcp-clients/raycast-screenshot.jpg new file mode 100644 index 00000000..e55072d0 Binary files /dev/null and b/docs/media/mcp-clients/raycast-screenshot.jpg differ diff --git a/todo.md b/todo.md index a29e7909..507e2d14 100644 --- a/todo.md +++ b/todo.md @@ -143,3 +143,6 @@ - fix readme css not taking effect because of tailwind css preflight which sets `img, video { height: auto }` - we still want this for every other scenario; just want to sandbox the github-style readme markdown css... - add `--llm` flag to cli (https://x.com/badlogicgames/status/1940370344990441726) +- support claude Desktop Extensions ([DXT](https://github.com/anthropics/dxt)) ([post](https://www.anthropic.com/engineering/desktop-extensions)) +- add mcp-remote to support stdio-only mcp clients like claude desktop +- add docs on how to use with [chatgpt's mcp custom connectors](https://platform.openai.com/docs/mcp) ([requires pro account or team/enterprise/edu workspace](https://help.openai.com/en/articles/11487775-connectors-in-chatgpt#h_d2a53d4230))