Skip to main content
Hi Doctor is a remote MCP server at https://mcp.hi-doctor.ai/mcp. In VS Code you add it with MCP: Add Server, then sign in on hi-doctor.ai when the server starts, and the chat agent can use the Hi Doctor tools you select. No client ID, secret or header is needed in the configuration. Last reviewed: 2026-11-04 Sign-in and approval are the same as in every client; see Connect.

Add the server

1

Run MCP: Add Server

Open the Command Palette (Ctrl+Shift+P, or Cmd+Shift+P on macOS) and run MCP: Add Server, or open Chat: Open Customizations > MCP Servers and select Add Server. Choose the HTTP server type.
2

Enter the URL

Enter https://mcp.hi-doctor.ai/mcp and name the server hi-doctor.
3

Choose where to save it

Choose where to save it: the workspace (.vscode/mcp.json, or the portable .mcp.json when VS Code offers it) or a global destination such as Copilot Global, which applies to every workspace.
.vscode/mcp.json is the workspace file every VS Code install reads. It uses a top-level servers object:
.vscode/mcp.json

The portable .mcp.json file

VS Code offers the portable .mcp.json destination (top-level mcpServers) when its workspace-root configuration setting is enabled; it is marked experimental. Use one format per file; do not put a servers object in .mcp.json or an mcpServers object in .vscode/mcp.json.
.mcp.json

Trust and sign-in

Servers saved in the workspace inherit the workspace’s trust: in a trusted workspace they start without a separate prompt. Servers from other sources show a trust dialog when they first start or when their configuration changes. When the server starts, VS Code opens Hi Doctor’s sign-in page in your browser. Sign in and approve as described on Connect. No client ID, secret or header is needed in the configuration.

Choose the tools

In the Chat view, pick the agent, then select Configure Tools and tick the Hi Doctor tools the agent may use. You can also reference a tool directly in a prompt with #. Select only the Hi Doctor tools you need; a long tool list crowds the agent’s context, and VS Code caps how many tools one chat request can have enabled. Use MCP: List Servers to start, stop or restart the server and to open its output log.

Disconnect

Run MCP: List Servers, select hi-doctor and stop it, then delete its entry from .vscode/mcp.json (or .mcp.json) or from your global configuration. See Disconnecting for how long access already issued lasts.

Sources

Checked on 2026-11-04 against VS Code’s MCP servers, MCP configuration reference and Use tools with agents pages. If a step differs, follow VS Code’s current page. If sign-in does not start, see Troubleshooting.

Frequently asked questions

Do I need a client ID to use Hi Doctor in VS Code?

No. Add only the server URL. VS Code registers itself with Hi Doctor and opens the sign-in page in your browser.

Should I use .mcp.json or .vscode/mcp.json?

Use .vscode/mcp.json unless VS Code offers the portable .mcp.json destination in your setup. Each file has its own format, so do not mix them.

Does VS Code ask me to trust the Hi Doctor server?

Not when it is saved in a trusted workspace: workspace servers inherit its trust and start without a separate prompt. Servers from other sources show a trust dialog first.

Do I have to enable every Hi Doctor tool?

No. Under Configure Tools tick only the tools you need; a long list crowds the agent’s context.

How do I stop or restart the Hi Doctor server?

Run MCP: List Servers to start, stop or restart it and to open its output log.

Next steps

Workflows

Common tasks step by step.

Patient tools

Every tool the agent can use with your account.
Ready to see a doctor? Start a consultation on hi-doctor.ai.