atlassian-netscaler-mcp
An MCP (Model Context Protocol) server for Jira and Confluence Server / Data Center deployments that sit behind Citrix NetScaler SSO.
接入你的智能体
从发布者处安装。不是 PlugMCP 端点。
远程 URL 还是本机命令? 两种安装方式的区别
It captures the NetScaler session cookie via a real browser (Playwright), stores it in the OS keychain (or a 0600 file under $XDG_CONFIG_HOME/atlassian-mcp/cookies/ when no keychain is available), and attaches it to every Jira / Confluence request. API calls themselves authenticate with a Personal Access Token.
Most Atlassian MCP servers assume Atlassian Cloud or a simple API token. Enterprise Server/DC installs typically need more:
This server handles that and exposes a single MCP surface.
initialize handshake completes┌──────────────┐ MCP/SSE ┌──────────────────────┐ HTTPS + cookie + PAT ┌──────────────┐
│ MCP client │ ────────────► │ server.py (this) │ ───────────────────────► │ Jira / Conf │
│ │ ◄──────────── │ │ ◄─────────────────────── │ behind SSO │
└──────────────┘ └──────────┬───────────┘ └──────────────┘
│ on expired cookie
▼
┌───────────────┐ Playwright ┌──────────────┐
│ login.py │ ─────────────► │ SSO browser │
└───────┬───────┘ └──────────────┘
│ store cookie
▼
OS keychain / 0600 file
The NetScaler cookie alone won't authenticate you to Jira/Confluence — it only gets you past the gate. The PAT you set in CONFLUENCE_TOKEN / JIRA_TOKEN is what the APIs actually check. Both are required.
Requires Python 3.11+ and uv.
git clone https://github.com/paul-pfeiffer/atlassian-netscaler-mcp.git
cd atlassian-netscaler-mcp
# One-time: install the browser used for the SSO login flow
uv run --with playwright python -m playwright install chromium
cp .envrc.example .envrc
$EDITOR .envrc # fill in URLs and tokens
direnv allow # if you use direnv
Required:
ATLASSIAN_TOKEN is accepted as a fallback for both CONFLUENCE_TOKEN and JIRA_TOKEN if you have a single PAT that works for both.
Optional:
./scripts/mcp-start
The first call without a valid cookie opens a Chromium window for SSO; complete the login and the server resumes.
uv run login.py
One login covers both Jira and Confluence. The script exits as soon as you've reached the authenticated Atlassian view.
// e.g. Claude Desktop config
{
"mcpServers": {
"atlassian": {
"url": "http://127.0.0.1:8000/sse"
}
}
}
Some Jira instances require custom fields on issue creation that aren't discoverable from the API. Drop a profile under config/customers/<name>/profile.json — see config/customers/example/profile.json:
{
"jira": {
"project_overrides": {
"MYPROJ": {
"issue_type_overrides": {
"Story": {
"required_fields": ["customfield_12345"],
"default_fields": {
"customfield_12345": [{ "key": "DEFAULT-1" }]
}
}
}
}
}
}
}
Then set JIRA_CUSTOMER_PROFILE=<name>.
Profiles are validated against config/profile.schema.json at load time — a typo like default_fiedls fails loudly with a clear error instead of being silently ignored. Editors that honor the $schema field (VS Code, JetBrains) will autocomplete and live-validate while you edit.
0600 under $XDG_CONFIG_HOME/atlassian-mcp/cookies/. The process logs a warning on first fallback use.profile doctor CLI that previews which fields a given profile would inject for a project/issue-typeIssues and PRs welcome. Don't commit .envrc or customer profile files — config/customers/*/ is gitignored except for example/.
MIT.
Use at your own risk. This software interacts with corporate auth systems and stores session cookies locally; make sure your use complies with your employer's policies and the terms of service of the systems you connect to.
Unified MCP server for Jira & Confluence Server/DC behind Citrix NetScaler SSO — Playwright cookie capture + Keychain storage
工具
暂无工具列表。远程服务器在首次健康检查后会获得工具列表。
常见问题
在本页复制适用于 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 配置。它使用发布者的安装方式,而不是 PlugMCP 代理。
此记录未列出必需的环境变量。
Atlassian Netscaler 通过 stdio 在本地运行。
上次检查时间:2026-10-28。 Unified MCP server for Jira & Confluence Server/DC behind Citrix NetScaler SSO — Playwright cookie capture + Keychain storage