Skip to content

Commit fa39d03

Browse files
committed
docs: add OpenCode and Windsurf MCP setup instructions
1 parent 5fee590 commit fa39d03

File tree

1 file changed

+85
-30
lines changed

1 file changed

+85
-30
lines changed

docs/logto-cloud/logto-mcp-server.mdx

Lines changed: 85 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -21,48 +21,103 @@ More capabilities are coming soon, including sign-in experience configuration, R
2121

2222
## Set up in your AI application
2323

24-
### VS Code
24+
### Claude Desktop
2525

26-
1. Open the command palette (`Command + Shift + P`), and select **MCP: Add Server...**.
27-
2. Choose **HTTP** as the server type.
28-
3. Enter the URL: `https://mcp.logto.io`. You can choose to install it to your workspace for better isolation and management.
29-
4. When the OAuth flow starts, enter the App ID: `mcp-client`. Leave the App Secret empty and press Enter to skip.
30-
5. You will be redirected to the Logto Cloud sign-in page. Sign in with your Logto Cloud account to connect.
26+
1. Open **Settings** from the main menu, navigate to **Connectors**, and click **Add custom connector**.
27+
2. Enter the name `Logto MCP Server` and the remote MCP server URL: `https://mcp.logto.io`.
28+
3. Expand **Advanced settings** and enter the OAuth Client ID: `mcp-client`. Click **Add**.
29+
4. In the **Connectors** list, find **Logto MCP Server** and click **Connect**.
30+
5. You will be redirected to the Logto Cloud sign-in page. Sign in and authorize to connect.
3131

3232
### Cursor
3333

3434
1. Open the command palette (`Command + Shift + P`), and select **View: Open MCP Settings**.
3535
2. In the **Installed MCP Servers** section, click the **Add Custom MCP** button.
3636
3. In the `mcp.json` file that opens, add the following configuration:
3737

38-
```json
39-
{
40-
"mcpServers": {
41-
"logto": {
42-
"command": "npx",
43-
"args": [
44-
"mcp-remote",
45-
"https://mcp.logto.io",
46-
"--allow-http",
47-
"--static-oauth-client-info",
48-
"{ \"client_id\": \"mcp-client\", \"scope\": \"mcp:all\" }",
49-
"--resource",
50-
"https://mcp.logto.io/"
51-
]
52-
}
53-
}
54-
}
55-
```
38+
```json
39+
{
40+
"mcpServers": {
41+
"Logto": {
42+
"command": "npx",
43+
"args": [
44+
"mcp-remote",
45+
"https://mcp.logto.io",
46+
"--allow-http",
47+
"--static-oauth-client-info",
48+
"{ \"client_id\": \"mcp-client\", \"scope\": \"mcp:all\" }",
49+
"--resource",
50+
"https://mcp.logto.io/"
51+
]
52+
}
53+
}
54+
}
55+
```
5656

5757
A Logto Cloud sign-in page will appear automatically. Sign in with your Logto Cloud account to connect.
5858

59-
### Claude Desktop
59+
### OpenCode
60+
61+
1. Add the following configuration to your `opencode.json` file:
62+
63+
```json
64+
{
65+
"$schema": "https://opencode.ai/config.json",
66+
"mcp": {
67+
"Logto": {
68+
"enabled": true,
69+
"type": "remote",
70+
"url": "https://mcp.logto.io",
71+
"oauth": {
72+
"clientId": "mcp-client"
73+
}
74+
}
75+
}
76+
}
77+
```
78+
79+
2. Run the following command to authenticate:
80+
```bash
81+
opencode auth Logto
82+
```
83+
Note that `Logto` corresponds to the MCP server name in your configuration file.
84+
85+
A browser window will open. Sign in with your Logto Cloud account to authorize and connect.
6086

61-
1. Open **Settings** from the main menu, navigate to **Connectors**, and click **Add custom connector**.
62-
2. Enter the name `Logto MCP Server` and the remote MCP server URL: `https://mcp.logto.io`.
63-
3. Expand **Advanced settings** and enter the OAuth Client ID: `mcp-client`. Click **Add**.
64-
4. In the **Connectors** list, find **Logto MCP Server** and click **Connect**.
65-
5. You will be redirected to the Logto Cloud sign-in page. Sign in and authorize to connect.
87+
### VS Code
88+
89+
1. Open the command palette (`Command + Shift + P`), and select **MCP: Add Server...**.
90+
2. Choose **HTTP** as the server type.
91+
3. Enter the URL: `https://mcp.logto.io`. You can choose to install it to your workspace for better isolation and management.
92+
4. When the OAuth flow starts, enter the App ID: `mcp-client`. Leave the App Secret empty and press Enter to skip.
93+
5. You will be redirected to the Logto Cloud sign-in page. Sign in with your Logto Cloud account to connect.
94+
95+
### Windsurf
96+
97+
1. Open the command palette (`Command + Shift + P`) and select **Windsurf: MCP Marketplace**.
98+
2. In the **Installed MCPs** section, click the settings icon on the right to create and open the `~/.codeium/windsurf/mcp_config.json` file.
99+
3. Add the following [configuration](https://docs.windsurf.com/windsurf/cascade/mcp#mcp_config-json):
100+
101+
```json
102+
{
103+
"mcpServers": {
104+
"Logto": {
105+
"command": "npx",
106+
"args": [
107+
"mcp-remote",
108+
"https://mcp.logto.io",
109+
"--allow-http",
110+
"--static-oauth-client-info",
111+
"{ \"client_id\": \"mcp-client\", \"scope\": \"mcp:all\" }",
112+
"--resource",
113+
"https://mcp.logto.io/"
114+
]
115+
}
116+
}
117+
}
118+
```
119+
120+
A Logto Cloud sign-in page will appear automatically. Sign in with your Logto Cloud account to connect.
66121

67122
### Other MCP clients
68123

0 commit comments

Comments
 (0)