adoptai-mcp

Single CLI to connect Cursor, Claude Desktop, Windsurf, or VS Code to AdoptAI MCP integrations (GitHub, Salesforce, Notion, Figma, Canva).

Published npm name is adoptai-mcp (no org scope yet). When the @adoptai org is ready, rename the package to @adoptai/mcp and update MCP config args accordingly.

Quick start

npx adoptai-mcp add --app github --client cursor

One command walks through credentials, validates them against the live API, encrypts and stores them under ~/.adoptai/, and adds an mcpServers entry to your client config.

Commands

| Command | Description | |--------|-------------| | add --app <name> --client <client> | Interactive setup for one app | | add --apps a,b,c --client <client> | Set up several apps in sequence | | remove --app <name> --client <client> | Remove server from client; optional credential delete | | list | Apps, tool counts, and whether credentials exist | | status | Which clients reference AdoptAI servers and total tools for authenticated apps | | serve --app <name> | Internal — stdio MCP server (used by client configs) |

Clients: cursor | claude | windsurf | vscode (VS Code uses code --add-mcp when available).

MCP config shape

Each app is registered as <app>-adoptai, for example:

{
  "mcpServers": {
    "salesforce-adoptai": {
      "command": "npx",
      "args": ["-y", "adoptai-mcp", "serve", "--app", "salesforce"],
      "env": {}
    }
  }
}

Build (from repo)

cd packages/adoptai-mcp
npm install
npm run build
npm link
adoptai-mcp list

npm run build runs build.mjs (esbuild): it bundles src/ plus the monorepo integrations/ tree into dist/cli/ and shared dist/chunks/, inlines JSON fixtures (so dist/specs/ is not shipped), and copies core/auth-manager.cjs for CommonJS interop. The published package does not include src/ or raw integrations/.

Size: Full Salesforce + GitHub tool surfaces produce a multi‑MB install (mostly inlined Postman/OpenAPI JSON). A sub‑1 MB tarball is not realistic without dropping specs/tools.

Local checks

1. node --check dist/cli/index.js
2. adoptai-mcp list (after npm link)
3. adoptai-mcp add --app github --client cursor (requires network + valid token)
4. Confirm ~/.cursor/mcp.json (or your client’s file) contains the new server
5. Restart the client and confirm tools appear

Salesforce authentication

The CLI uses SOAP login (username + password + security token) and stores the resulting session id as the REST bearer token. Use Sandbox when prompted if your org logs in via test.salesforce.com.

License

MIT