Conector

<p align="center">
  <img src="docs/assets/banner.png" alt="Conector: one MCP server for all your apps" width="100%">
</p>

<p align="center">
  <b>Connect 1,178 apps once and use them from Claude, Codex, Cursor, Gemini CLI, GitHub Copilot and 42 more AI agents.</b><br>
  Self-hosted and open source. Your credentials stay encrypted on your own server.
</p>

<p align="center">
  <a href="https://github.com/Secra-Solutions/Conector/releases/latest"><img alt="Latest release" src="https://img.shields.io/github/v/release/Secra-Solutions/Conector?style=flat-square&color=8b6cf2&label=release"></a>
  <a href="https://www.npmjs.com/package/conector"><img alt="npm" src="https://img.shields.io/npm/v/conector?style=flat-square&color=8b6cf2"></a>
  <a href="https://github.com/Secra-Solutions/Conector/actions/workflows/ci.yml"><img alt="Tests" src="https://img.shields.io/github/actions/workflow/status/Secra-Solutions/Conector/ci.yml?branch=main&style=flat-square&label=tests"></a>
  <a href="LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/license-MIT-8b6cf2?style=flat-square"></a>
  <img alt="Node.js 22+" src="https://img.shields.io/badge/node-22%2B-8b6cf2?style=flat-square">
  <img alt="MCP: Streamable HTTP" src="https://img.shields.io/badge/MCP-Streamable%20HTTP-8b6cf2?style=flat-square">
  <img alt="1,178 apps" src="https://img.shields.io/badge/apps-1%2C178-8b6cf2?style=flat-square">
  <img alt="47 agents" src="https://img.shields.io/badge/agents-47-8b6cf2?style=flat-square">
  <a href="https://secra.es/en"><img alt="Powered by Secra Solutions" src="https://img.shields.io/badge/powered%20by-Secra%20Solutions-16131f?style=flat-square&labelColor=8b6cf2"></a>
</p>

<p align="center">
  <a href="#quick-start">Quick start</a> ·
  <a href="#connect-an-agent">Agents</a> ·
  <a href="#apps">Apps</a> ·
  <a href="#users-and-security">Security</a> ·
  <a href="docs/ADDING_APPS.md">Add an app</a> ·
  <a href="#powered-by-secra-solutions">About</a>
</p>

<p align="center">
  <img src="docs/assets/demo.gif" alt="Demo: search the app catalog, connect Hacker News, then add Conector to Claude Code with a new token" width="900">
</p>

## Why Conector

AI agents can only use the tools they can reach. Wiring every agent to every app means juggling API keys, OAuth apps and
config files on each machine, for each agent. Conector puts all of it in one place:

1. **Connect an app once** in the web panel, by signing in or pasting an API key.
2. **Add Conector to your agents** with one command or config snippet.
3. **Every agent gets tools for every app you connected**, over the [Model Context Protocol](https://modelcontextprotocol.io).

<p align="center">
  <img src="docs/assets/how-it-works.png" alt="Agents talk to Conector over MCP with an access token; Conector talks to your apps with OAuth or an API key" width="100%">
</p>

## Features

<table>
  <tr>
    <td width="33%" valign="top">
      <b>1,178 apps</b><br>
      GitHub, Gmail, Google Drive, Notion, Slack, Linear, HubSpot, Salesforce, Stripe, Microsoft 365, Jira and more.
      107 connect with one click. The rest take an API key, a username and password, or nothing at all.
    </td>
    <td width="33%" valign="top">
      <b>1,416 tools</b><br>
      Every app gets an authenticated <code>&lt;app&gt;_request</code> tool for its whole API. Many add specific tools such
      as <code>outlook_search_mail</code>, <code>jira_search</code> or <code>slack_send_message</code>.
    </td>
    <td width="33%" valign="top">
      <b>47 agents</b><br>
      The panel shows the exact command or config file for each agent, with a token already filled in.
      <code>conector install &lt;agent&gt;</code> writes it for you.
    </td>
  </tr>
  <tr>
    <td valign="top">
      <b>Built for teams</b><br>
      Admins and members, invitation links, personal and shared connections, and per-agent tokens limited to the apps
      you choose.
    </td>
    <td valign="top">
      <b>Private by design</b><br>
      Credentials are encrypted with AES-256-GCM and only sent to the app they belong to. The panel loads no external
      scripts, fonts or images.
    </td>
    <td valign="top">
      <b>Easy to run</b><br>
      Node.js and three dependencies, or one <code>docker compose up</code>. Every tool call is recorded in an audit log.
    </td>
  </tr>
</table>

## Quick start

With [Node.js](https://nodejs.org) 22 or later, in one command:

```bash
npx conector start
```

Installed from npm, Conector keeps its data in `~/.conector`. For a permanent install, run `npm install -g conector` and
then `conector start`.

With Docker:

```bash
docker run -d --name conector -p 127.0.0.1:8790:8790 -v conector-data:/data ghcr.io/secra-solutions/conector
docker logs conector    # shows the setup link
```

Or from source:

```bash
git clone https://github.com/Secra-Solutions/Conector.git
cd Conector
npm install
npm start
```

The first start prints a one-time setup link:

```
Conector 0.1.0 listening on http://127.0.0.1:8790 — public URL http://localhost:8790
No users yet. Create the admin account at:
  http://localhost:8790/setup?code=…
```

Open it, create the admin account, and then:

1. **Apps:** pick an app and connect it.
2. **Connect agents:** pick your agent, click **Create a token**, and copy the command or snippet.
3. Ask your agent to use the app, for example: "list my open GitHub pull requests".

### With Docker Compose

From a clone of the repository:

```bash
docker compose up -d
docker compose logs conector    # shows the setup link
```

The data (users, tokens, encrypted credentials and the master key) lives in the `conector-data` volume. The compose
file only exposes the panel on `127.0.0.1:8790`. Images for amd64 and arm64 are published at
`ghcr.io/secra-solutions/conector`: `latest` and `X.Y.Z` for releases, `edge` for the main branch.

## Connect an agent

<p align="center">
  <img src="docs/screenshots/agent.png" alt="Adding Conector to Claude Code" width="900">
</p>

Each agent authenticates with its own access token (`cnr_…`) and talks to `http://<server>/mcp` over Streamable HTTP,
with an `Authorization: Bearer` header. Agents that can only start local (stdio) servers use the bundled bridge,
`bin/stdio-bridge.js` (or `conector stdio`), configured with `CONECTOR_URL` and `CONECTOR_TOKEN`. It has no
dependencies, so you can copy it to any machine with Node.js. On the machine where Conector stores its data, an agent
can also start `conector mcp`, which serves the same tools over stdio without the web server or a token.

**Everything on one machine?** Start the panel with `npx conector start`, connect your apps, and add Conector to your
editor in one click. The button adds `npx -y conector mcp`, which reads the same data in `~/.conector`, so there's no
token to create:

<p>
  <a href="https://vscode.dev/redirect/mcp/install?name=conector&config=%7B%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22conector%22%2C%22mcp%22%5D%7D"><img alt="Install in VS Code" src="https://img.shields.io/badge/VS_Code-Install_Conector-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white"></a>
  <a href="https://insiders.vscode.dev/redirect/mcp/install?name=conector&config=%7B%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22conector%22%2C%22mcp%22%5D%7D&quality=insiders"><img alt="Install in VS Code Insiders" src="https://img.shields.io/badge/VS_Code_Insiders-Install_Conector-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white"></a>
  <a href="https://cursor.com/en/install-mcp?name=conector&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImNvbmVjdG9yIiwibWNwIl19"><img alt="Add Conector to Cursor" src="https://cursor.com/deeplink/mcp-install-dark.svg" height="20"></a>
</p>

| | Agents |
|---|---|
| **CLIs** | Claude Code, Codex, Gemini CLI, OpenCode, Amp, goose, Qwen Code, Factory Droid, Devin CLI, TRAE CLI, Mistral Vibe, Kimi Code CLI, Grok Build, Hermes Agent, Auggie CLI, CodeBuddy Code, Qoder CLI, MiniMax Code, Cortex Code, Deep Agents, fast-agent, Stakpak, ZCode, Pi, Oh My Pi, Muse Code, Autohand Code, CodeWhale, crow-cli, DimCode, Gajae Code, Minion Code, Nova, Poolside, siGit Code, VT Code, GLM Agent, Corust Agent |
| **Editors** | Cursor, GitHub Copilot (VS Code), Cline, Kilo Code, Kiro, Junie, Google Antigravity |
| **Desktop and web** | Claude Desktop, Hoplite |
| **Not supported yet** | ChatGPT (it requires OAuth for MCP servers), Agoragentic and Dirac (they have no way to add MCP servers) |

From the panel, open **Connect agents**, pick your agent and click **Create a token**. Or, from a terminal on the server:

```bash
npm link                                    # makes the `conector` command available
conector agents                             # list the supported agents
conector install claude-code                # runs `claude mcp add …` with a new token
conector install cursor --user you@example.com
conector install codex --dry-run            # show what it would do
```

`conector install` uses the agent's own CLI when it is installed. Otherwise it merges the entry into the agent's JSON or
TOML config file and keeps a `.conector-backup` copy. When a file can't be merged safely (JSONC comments, YAML, an
existing table), it prints the snippet for you to paste.

## Apps

<p align="center">
  <img src="docs/screenshots/apps.png" alt="The app catalog" width="900">
</p>

Each app page offers the simplest way to connect it:

- **Continue with …:** OAuth sign-in. An admin registers Conector's OAuth app once per provider under **OAuth apps**.
  The page shows the redirect URI and scopes to use. One registration covers all of the provider's apps: one Google
  OAuth app covers Gmail, Drive, Calendar, Sheets and the rest.
- **API key, or username and password:** step-by-step instructions to find the key, and a connection test when you save.
- **Enable:** public APIs that need no credentials.
- **Microsoft 365:**