NicoChatNicoChatDocsSearch the docs…
Sign in
NicoChat MCP/VS Code - Connect the MCP

VS Code - Connect the MCP

Register the server in mcp.json with type http and use it through Copilot Chat in agent mode.

2026-09-08

In VS Code, MCP servers are used by GitHub Copilot Chat in agent mode. NicoChat goes into mcp.json as a server of type http; on startup, VS Code detects the OAuth and asks you to authorize in the browser.

Before you start

  • Server URL: https://mcp.nicochat.com/mcp. It is the only information the client asks for; there is no API key to copy.
  • A NicoChat account with a workspace on a paid or trial plan, and you as its owner or admin.
  • VS Code up to date with the GitHub Copilot Chat extension and a Copilot subscription.
  • In organizations, the GitHub admin needs to have the MCP server policy enabled.

Step by step

1
Add the server
Open the command palette and run MCP: Add Server. Choose HTTP (HTTP or Server-Sent Events), paste the server URL and give it the name nicochat.
2
Choose the scope
VS Code asks whether the server applies to the user (all projects) or to the current workspace. In the workspace, it writes to .vscode/mcp.json, a file that can go into the repository.
3
Start and authorize
In the open mcp.json file, click Start above the server. VS Code shows that the server requires authentication and opens the browser on the NicoChat authorization. Log in, choose permissions and validity and confirm.
4
Use it in Copilot Chat
Open Copilot Chat, switch to Agent mode and check, under the tools icon, that the nicochat server is ticked.

If you prefer to write the file by hand, this is the content of .vscode/mcp.json. Note that the key is servers and the type field is required:

json
{
  "servers": {
    "nicochat": {
      "type": "http",
      "url": "https://mcp.nicochat.com/mcp"
    }
  }
}

The authorization screen

Whatever the client, authorization happens in the browser, on the NicoChat page. You log in, choose the permissions (read and analytics is always granted; configuration, contacts, integrations and campaigns are optional) and the validity of the connection: 1, 7, 30 or 90 days, or no expiration. The tools the assistant sees depend on what you checked here — to expand later, just reconnect.

Start with read only
On the first connection, grant only read and analytics and ask for a diagnosis of your channels. Once you are comfortable with what the assistant does, reconnect granting configuration or contacts.

First requests to try

With the connection in place, ask Copilot in natural language. Some examples that use read only:

  • "List my workspaces and the channels in each one."
  • "How many contacts entered the WhatsApp channel in the last 7 days and what is the average first response time?"
  • "Summarize the structure of channel X: flows, triggers, AI agents and kanban boards."
  • "Which keywords are configured in channel X and where does each one lead?"

If you granted configuration, the assistant also creates flows, triggers, tags and AI agents. Everything it creates inside a flow stays as a draft until you publish it in NicoChat.

128-tool limit
VS Code accepts at most 128 active tools per request. NicoChat exposes more than that when all permissions are granted. Connect only with the permissions you need, or uncheck tool groups under the chat tools icon.

Disconnect or revoke

  • In the client: run MCP: List Servers, choose nicochat and Uninstall, or delete the block from mcp.json.
  • In NicoChat: in Account Settings, revoke the authorization. The effect is immediate, even if the server is still registered in the client.

Common problems

Every server in mcp.json needs "type": "http" or "type": "stdio". Without the field, VS Code rejects the block.
Run MCP: List Servers › nicochat › Restart. If it persists, use the account in Accounts (bottom left corner) to remove the stored authorization and do it again.
Copy the link the client shows and open it manually. If it shows no link at all, remove the server and add it again: the client registration in NicoChat is redone on first access.
That is expected when only the read permission was granted. Disconnect and connect again, checking the write permissions you need.
The server only operates in workspaces on a paid or trial plan where you are the owner or an admin. Check the plan and your role in the workspace in the NicoChat dashboard.
The validity you chose during authorization expired. Reconnect and, if you prefer, choose "no expiration".