Repository navigation
Releases
MCP Connector v0.2.0-beta.1
This is a beta. Everything an agent changes still waits for your approval
in the app, but expect rough edges, and please report problems in
Issues.
Install on Windows (10 or 11, 64-bit)
- Download the
MCP-Connector-…-x64.exefile below and run it. - This beta is not code-signed yet, so Windows may say "Windows protected
your PC". Click More info, then Run anyway.
Install on Linux (64-bit)
-
Ubuntu, Debian and their derivatives: download
MCP-Connector-…-amd64.debbelow and install it:sudo apt install ./MCP-Connector-…-amd64.deb
Then open MCP Connector from your apps menu, or run
mcp-connector. On
Ubuntu 24.04, use the .deb: it allows the sandbox for itself (see below). -
Other distributions: download
MCP-Connector-…-x86_64.AppImage, make
it executable and run it:chmod +x MCP-Connector-…-x86_64.AppImage ./MCP-Connector-…-x86_64.AppImage
MCP Connector keeps your tokens in the system keyring, so it needs GNOME
Keyring or KWallet, installed and unlocked; GNOME, KDE, Xfce, Cinnamon and
most desktops come with one. If the app says no keyring is available, install
or unlock one, then restart MCP Connector. On a desktop it doesn't recognize,
such as i3 or Sway, start it with --password-store=gnome-libsecret to use
GNOME Keyring.
Its settings, database and logs are in ~/.config/@mcp-connector/desktop.
Set it up
- In MCP Connector, choose the folder agents may read, connect the services
you want, and click Start MCP server. - Under Copy the setup for your agent, copy the setup for Claude Code,
Cursor, VS Code (Copilot), Codex, Gemini CLI or Windsurf, and put it where
the app says.
To teach your agent how to use MCP Connector, also add the skill: download
mcp-connector-skill.zip and unzip it into your agent's skills folder (for
Claude Code, %USERPROFILE%\.claude\skills on Windows, ~/.claude/skills on
Linux).
The Linux AppImage
The AppImage needs FUSE 2. On Ubuntu 24.04 and newer, install it with
sudo apt install libfuse2t64; on Ubuntu 22.04, with sudo apt install libfuse2.
Ubuntu 23.10 and newer, including 24.04 LTS, restrict the user namespaces that MCP Connector's
sandbox needs, for programs AppArmor doesn't know. The .deb installs an
AppArmor profile that allows them, so it starts normally. The AppImage has no
profile: MCP Connector then says it can't start safely and closes, rather than
run without its sandbox. Either install the .deb, or allow the AppImage with
this profile, which covers MCP-Connector-*.AppImage files anywhere in your
home folder:
sudo tee /etc/apparmor.d/mcp-connector-appimage > /dev/null <<'EOF'
abi <abi/4.0>,
include <tunables/global>
profile mcp-connector-appimage @{HOME}/**/MCP-Connector-*.AppImage flags=(unconfined) {
userns,
}
EOF
sudo apparmor_parser -r /etc/apparmor.d/mcp-connector-appimageDon't start it with --no-sandbox: MCP Connector refuses to run that way.
If you set up an agent with Copy stdio setup, the setup points at the
AppImage file, so keep it where it was when you copied the setup.
Also attached
mcp-connector-vscode-….vsix: the optional VS Code extension that shares
your active editor with MCP Connector.
Known limits
- Notion sign-in isn't available yet; it comes in a later release. GitHub
sign-in and the other MCP servers you add work now. - No automatic updates yet: download new versions from this page.
- MCP servers you add with
npxneed Node.js installed.
What's Changed
- MCP Connector 0.2: Linux AppImage and .deb, plus beta polish by @qwaziestatic in #15
Full Changelog: v0.1.0-beta.1...v0.2.0-beta.1
MCP Connector v0.1.0-beta.1
This is a beta. Everything an agent changes still waits for your approval
in the app, but expect rough edges, and please report problems in
Issues.
Install (Windows 10 or 11, 64-bit)
- Download the
MCP-Connector-…-x64.exefile below and run it. - This beta is not code-signed yet, so Windows may say "Windows protected
your PC". Click More info, then Run anyway. - In MCP Connector, choose the folder agents may read, connect the services
you want, and click Start MCP server. - Under Copy the setup for your agent, copy the setup for Claude Code,
Cursor, VS Code (Copilot), Codex, Gemini CLI or Windsurf, and put it where
the app says.
To teach your agent how to use MCP Connector, also add the skill: download
mcp-connector-skill.zip and unzip it into your agent's skills folder (for
Claude Code, %USERPROFILE%\.claude\skills).
Also attached
mcp-connector-vscode-….vsix: the optional VS Code extension that shares
your active editor with MCP Connector.
Known limits
- Notion sign-in isn't available yet; it comes in a later release. GitHub
sign-in and the other MCP servers you add work now. - No automatic updates yet: download new versions from this page.
- MCP servers you add with
npxneed Node.js installed.
What's Changed
- Harden workspace path checks and rejected preview handling by @qwaziestatic in #1
- Keep rejected previews out of the pending queue by @qwaziestatic in #2
- Show preview content in the approval queue by @qwaziestatic in #3
- Upgrade Electron to 45 and make the packaged app start by @qwaziestatic in #4
- Start the MCP server without Notion configured by @qwaziestatic in #5
- Launch the packaged app in CI by @qwaziestatic in #6
- Apply the Nov 3 review patches by @qwaziestatic in #7
- Show startup errors, list workspace links, and fix hot reload by @qwaziestatic in #8
- Connect agents reliably: stable MCP setup, stdio relay, notifications by @qwaziestatic in #9
- Sign in without shipping client secrets, and run one copy per data folder by @qwaziestatic in #10
- Add connector definitions, more agent setups, and the Agensi skill by @qwaziestatic in #11
- Offer other MCP servers' tools behind the same approvals by @qwaziestatic in #12
- Prepare the first beta: MIT license, app icon, and release fixes by @qwaziestatic in #13
- Never let electron-builder publish by itself by @qwaziestatic in #14
New Contributors
- @qwaziestatic made their first contribution in #1
Full Changelog: https://github.com/qwaziestatic/MCP-connector/commits/v0.1.0-beta.1