Skip to content

Commit b9db8bd

Browse files
[Feature] Added MCP page to docs (#963)
* Create documentation for Seqera MCP integration Added documentation for Seqera MCP, detailing features, authentication methods, and client setup instructions. Signed-off-by: Justine Geffen <[email protected]> * Update cloud-sidebar.json Signed-off-by: Justine Geffen <[email protected]> * Apply suggestion from @justinegeffen Signed-off-by: Justine Geffen <[email protected]> * Update seqera-mcp.md Signed-off-by: Justine Geffen <[email protected]> --------- Signed-off-by: Justine Geffen <[email protected]>
1 parent c24b8ee commit b9db8bd

File tree

2 files changed

+129
-1
lines changed

2 files changed

+129
-1
lines changed

platform-cloud/cloud-sidebar.json

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -189,7 +189,8 @@
189189
"seqerakit/templates"
190190
]
191191
},
192-
"pipeline-actions/overview"
192+
"pipeline-actions/overview",
193+
"seqera-mcp"
193194
]
194195
},
195196
{

platform-cloud/docs/seqera-mcp.md

Lines changed: 127 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,127 @@
1+
---
2+
title: "Seqera MCP"
3+
description: "Connect AI assistants to Seqera Platform using the Model Context Protocol"
4+
date created: "2025-12-12"
5+
tags: [mcp, integration, mcp-server, ai]
6+
---
7+
8+
Seqera MCP is a [Model Context Protocol](https://modelcontextprotocol.io/) server that enables AI assistants to interact with the Seqera ecosystem. It provides access to Seqera Platform, Wave containers, nf-core modules, and bioinformatics data resources.
9+
10+
## Features
11+
12+
- **Seqera Platform integration**: Launch, monitor, and manage Nextflow pipelines.
13+
- **Wave container service**: Create containerized environments with conda/pip packages.
14+
- **nf-core modules**: Search and execute 1000+ standardized bioinformatics modules.
15+
16+
## Remote server
17+
18+
The hosted Seqera MCP server is available at:
19+
20+
```console
21+
https://mcp.seqera.io/mcp
22+
```
23+
24+
## Authentication
25+
26+
Seqera MCP supports two authentication methods:
27+
28+
- **OAuth 2.1** (recommended): Interactive login through Seqera Platform. Your browser opens automatically to authenticate when connecting.
29+
- **Personal Access Token**: Use your Seqera Platform [access token](https://docs.seqera.io/platform-cloud/credentials/overview) as a Bearer token. Useful for clients that don't support OAuth.
30+
31+
## Client setup
32+
33+
### Claude Code
34+
35+
```bash
36+
claude mcp add seqera --url https://mcp.seqera.io/mcp
37+
```
38+
39+
### Claude Desktop
40+
41+
1. Open Claude Desktop settings.
42+
2. Select **Add connectors**.
43+
3. Click **Add custom connector**.
44+
4. Enter the URL: `https://mcp.seqera.io/mcp`.
45+
5. Select **OAuth** as the authentication method.
46+
47+
### Cursor
48+
49+
Create or edit `~/.cursor/mcp.json`:
50+
51+
```json
52+
{
53+
"mcpServers": {
54+
"seqera": {
55+
"url": "https://mcp.seqera.io/mcp"
56+
}
57+
}
58+
}
59+
```
60+
61+
Restart Cursor to apply the configuration. On first use, your browser will open for authentication.
62+
63+
### OpenAI Codex
64+
65+
First, enable the MCP client feature in `~/.codex/config.toml`:
66+
67+
```toml
68+
[features]
69+
rmcp_client = true
70+
```
71+
72+
Then add the Seqera MCP server and authenticate:
73+
74+
```bash
75+
codex mcp add seqera --url https://mcp.seqera.io/mcp
76+
codex mcp login seqera
77+
```
78+
79+
### VS Code
80+
81+
Create or edit `~/Library/Application Support/Code/User/mcp.json` (macOS) or `%APPDATA%\Code\User\mcp.json` (Windows):
82+
83+
```json
84+
{
85+
"servers": {
86+
"seqera": {
87+
"url": "https://mcp.seqera.io/mcp",
88+
"type": "http"
89+
}
90+
}
91+
}
92+
```
93+
### Windsurf
94+
95+
Create or edit `~/.codeium/windsurf/mcp_config.json`:
96+
97+
```json
98+
{
99+
"mcpServers": {
100+
"seqera": {
101+
"serverUrl": "https://mcp.seqera.io/mcp"
102+
}
103+
}
104+
}
105+
```
106+
107+
### Using Personal Access Token
108+
109+
For clients that don't support OAuth, add your access token as a header:
110+
111+
```json
112+
{
113+
"mcpServers": {
114+
"seqera": {
115+
"url": "https://mcp.seqera.io/mcp",
116+
"headers": {
117+
"Authorization": "Bearer <YOUR_ACCESS_TOKEN>"
118+
}
119+
}
120+
}
121+
}
122+
```
123+
124+
## Resources
125+
126+
- [Model Context Protocol specification](https://modelcontextprotocol.io/)
127+

0 commit comments

Comments
 (0)