--- title: "Add SuperEbook to GitHub Copilot’s CLI and IDEs" description: "Add SuperEbook’s MCP server to GitHub Copilot in the CLI, Visual Studio, JetBrains IDEs, Xcode and Eclipse: each one’s config, an API key, and the admin policy." url: "https://www.superebook.ai/mcp/github-copilot" --- # Add SuperEbook to GitHub Copilot. The CLI, Visual Studio, JetBrains, Xcode and Eclipse. GitHub Copilot can use SuperEbook’s MCP server wherever it runs, and plan and write books in your SuperEbook account from your code and notes. The server is the same everywhere, but each app reads its config a little differently: here is the right entry for each. For VS Code, see [its own guide](https://www.superebook.ai/mcp/vscode.md). ## Before you start - **A SuperEbook account with Starter, Pro or any credit pack.** SuperEbook’s Free plan doesn’t include connecting apps: [see plans](https://www.superebook.ai/pricing.md). - **An API key**, for every app here but Visual Studio, which signs in instead. In [Settings → Connect apps](https://www.superebook.ai/settings?tab=apps), choose Create API key and copy it: you see the whole key only once, it starts `ebk_live_`, and it needs a verified email address. Give each app its own key. - **Copilot Business or Enterprise:** an admin must turn on the MCP servers in Copilot policy first; it’s off by default. Copilot Free, Pro, Pro+ and Max aren’t governed by it. - **The www address**, `https://www.superebook.ai/api/mcp`, in every app: the address without www can’t sign you in. ## Server URL `https://www.superebook.ai/api/mcp` ## Copilot CLI 1. Create an API key. In SuperEbook, open [Settings → Connect apps](https://www.superebook.ai/settings?tab=apps) and choose Create API key. Name it after the Copilot CLI, then copy it: you see the whole key only once, and it starts `ebk_live_`. It needs a verified email address. 2. In a Copilot CLI session, enter /mcp add. Move between fields with Tab. Server Name: `superebook`. Server Type: press the number for HTTP or SSE. URL: `https://www.superebook.ai/api/mcp`. HTTP Headers: `{"Authorization": "Bearer ebk_live_YOUR_KEY"}`. Tools: `*`. Press Ctrl+S: the server works at once, with no restart. Or add it with one command, which saves it to `~/.copilot/mcp-config.json`. The key also lands in your shell history, so the form or the file is safer: ``` copilot mcp add --transport http --header "Authorization: Bearer ebk_live_YOUR_KEY" superebook https://www.superebook.ai/api/mcp ``` Or write it in `~/.copilot/mcp-config.json` yourself. A project’s `.mcp.json` or `.github/mcp.json` works too, but loads only after you trust the folder, and never commit a real key to one. The CLI doesn’t read `.vscode/mcp.json`. ``` { "mcpServers": { "superebook": { "type": "http", "url": "https://www.superebook.ai/api/mcp", "headers": { "Authorization": "Bearer ebk_live_YOUR_KEY" }, "tools": [ "*" ] } } } ``` > **Not yet tested.** To sign in instead of using a key, add the server without the header and run `/mcp auth`. The CLI’s changelog says it signs in to MCP servers through the browser with dynamic client registration, but nobody has tried it with SuperEbook yet. SuperEbook’s page opens in your browser. If the app is coming back to your own computer, the page names it, with no warning; if it isn’t, the page warns you, and you tick the box only if you started connecting yourself. Then choose Allow. ## Visual Studio 1. Open the chat pane and switch to Agent mode. Visual Studio 2022 17.14 or later, or Visual Studio 2026. 2. Select Tools, then the plus (+) button. In Visual Studio 2026 choose Add custom MCP server; in Visual Studio 2022 the Add MCP server dialog opens. 3. Enter the name superebook, the type HTTP/SSE and the server URL, then Save. Or create `%USERPROFILE%\.mcp.json`, for every solution, or `.mcp.json` in a solution’s folder, with this: ``` { "servers": { "superebook": { "url": "https://www.superebook.ai/api/mcp" } } } ``` 4. Sign in from the code lens. In the `.mcp.json` file, choose Authentication Required above the server (later, Manage Authentication) and sign in in the browser window. If there’s no code lens, turn it on in Tools → Options → Text Editor → CodeLens. SuperEbook’s page opens in your browser. If the app is coming back to your own computer, the page names it, with no warning; if it isn’t, the page warns you, and you tick the box only if you started connecting yourself. Then choose Allow. 5. Turn on its tools. Tools start switched off: turn them on in the tool picker, then approve each one when asked (Allow in Visual Studio 2022, Confirm in 2026). > **Not yet tested.** Not yet tested from Visual Studio. Microsoft documents signing in to remote servers but no header, so there’s no key route here; if signing in fails, tell us. ## JetBrains IDEs 1. Open Copilot’s MCP settings. Click the Copilot icon in the lower right corner, choose Open Chat, and make sure you’re in Agent mode. Click the tools icon (Configure your MCP server) at the bottom of the chat, then Add MCP Tools. 2. Paste the entry into the mcp.json that opens. Replace `ebk_live_YOUR_KEY` with your key from [Settings → Connect apps](https://www.superebook.ai/settings?tab=apps). The header goes under `requestInit`. ``` { "servers": { "superebook": { "url": "https://www.superebook.ai/api/mcp", "requestInit": { "headers": { "Authorization": "Bearer ebk_live_YOUR_KEY" } } } } } ``` 3. Click the tools icon again: superebook’s tools are listed. ## Xcode 1. Open GitHub Copilot for Xcode’s settings. It needs the GitHub Copilot for Xcode extension. In a workspace, use Editor → GitHub Copilot → Open GitHub Copilot for Xcode Settings. 2. Select the MCP tab, click Edit Config, and paste the entry. The same entry as JetBrains’, with your key in place of the placeholder. ``` { "servers": { "superebook": { "url": "https://www.superebook.ai/api/mcp", "requestInit": { "headers": { "Authorization": "Bearer ebk_live_YOUR_KEY" } } } } } ``` ## Eclipse 1. Open Copilot’s MCP settings. Eclipse 2024-09 or later. Click the Copilot icon in the status bar, choose Open Chat, then the Configure Tools… icon. Or go to Edit preferences → GitHub Copilot → MCP. 2. Paste the entry under Server Configurations. The same entry as JetBrains’; Eclipse keeps it in its preferences, not a file. ``` { "servers": { "superebook": { "url": "https://www.superebook.ai/api/mcp", "requestInit": { "headers": { "Authorization": "Bearer ebk_live_YOUR_KEY" } } } } } ``` ## For organization admins - **Organization:** your profile picture → Organizations → the organization → Settings. In the sidebar, under Code, planning, and automation, click Copilot, then Policies. Under Features, set MCP servers in Copilot to Enabled. - **Enterprise:** the enterprise → AI controls → MCP, and set MCP servers in Copilot to Enabled everywhere. - If Restrict MCP access to registry servers is set to Registry only, only servers in your registry run, so SuperEbook needs adding to it. ## Try it Once it’s connected, ask for a book in plain words. Planning is free, and the app is told to quote the price and wait for your yes before it writes. - Read CHANGELOG.md and use SuperEbook to plan a how-to guide on upgrading to v3. - Turn docs/workshop.md into a SuperEbook workbook and show me the chapters first. - List my SuperEbook books. - How long until my book is written? ## If it doesn’t work | What you see | Code | What to do | | --- | --- | --- | | MCP servers are switched off | | On Copilot Business or Enterprise, the MCP servers in Copilot policy is off until an admin turns it on (see For organization admins). | | Only registry servers are allowed | | Your organization set Restrict MCP access to registry servers to Registry only. Ask an admin to add SuperEbook to the registry. | | The Copilot CLI ignores a project’s .mcp.json | | Project files load only after you trust the folder. The CLI never reads .vscode/mcp.json. | | Visual Studio shows no Authentication Required | | Turn on code lenses in Tools → Options → Text Editor → CodeLens, then open .mcp.json again. | | SuperEbook refuses the key | | Check the whole key follows “Bearer ” in the header, that the address has www, and that the key isn’t revoked in Settings. | For credits, limits and the other messages an app may relay, see [if something goes wrong](https://www.superebook.ai/mcp#troubleshooting). ## Questions **Which Copilot plans can use SuperEbook?** Any that includes Copilot in these apps. On Copilot Business and Enterprise, an admin must turn on the MCP servers in Copilot policy first; Copilot Free, Pro, Pro+ and Max aren’t governed by it. **Why does each Copilot app need a different entry?** They read different formats. The Copilot CLI uses mcpServers with type http and headers; JetBrains, Xcode and Eclipse use servers, with the header inside requestInit; Visual Studio’s documented remote server is servers with a url alone, signed in from a code lens. **Can Visual Studio use a SuperEbook API key?** Microsoft documents signing in for remote servers in Visual Studio, but no header, so this guide signs in there. Nobody has tried it with SuperEbook yet. **Does the Copilot CLI read VS Code’s mcp.json?** No. The CLI reads ~/.copilot/mcp-config.json, and a project’s .mcp.json or .github/mcp.json once you trust the folder, but not .vscode/mcp.json. ## Checked against GitHub’s docs on October 18, 2026 - [Adding MCP servers for GitHub Copilot CLI (GitHub docs)](https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers): /mcp add, copilot mcp add, ~/.copilot/mcp-config.json, project files and folder trust. - [GitHub Copilot CLI changelog](https://github.com/github/copilot-cli/blob/main/changelog.md): signing in to MCP servers with OAuth, and /mcp auth. - [Extending Copilot Chat with MCP (GitHub docs)](https://docs.github.com/en/copilot/how-tos/copilot-in-your-ide/customize-copilot/extend-copilot-with-tools-and-context/extend-copilot-chat-with-mcp): the JetBrains, Xcode and Eclipse menus and their config, and the MCP servers in Copilot policy. - [Restricting MCP server access based on a registry (GitHub docs)](https://docs.github.com/en/copilot/how-tos/administer-copilot/manage-mcp-usage/restrict-based-on-registry): turning the policy on for an organization or enterprise, and the registry-only setting. - [Use MCP servers in Visual Studio (Microsoft Learn)](https://learn.microsoft.com/en-us/visualstudio/ide/mcp-servers): versions, adding a server from chat or .mcp.json, signing in from the code lens, and turning tools on. ## More about connecting - [Claude app](https://www.superebook.ai/mcp/claude-app.md) - [Claude Code](https://www.superebook.ai/mcp/claude-code.md) - [Cursor](https://www.superebook.ai/mcp/cursor.md) - [VS Code](https://www.superebook.ai/mcp/vscode.md) - [Codex](https://www.superebook.ai/mcp/codex.md) - [Gemini CLI](https://www.superebook.ai/mcp/gemini-cli.md) - [Zed](https://www.superebook.ai/mcp/zed.md) - [Devin Desktop](https://www.superebook.ai/mcp/devin-desktop.md) - [Other apps](https://www.superebook.ai/mcp/other-apps.md)