Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.tryordinal.com/llms.txt

Use this file to discover all available pages before exploring further.

​
One-click install

Install the Ordinal MCP server. Sign in with your Ordinal account when prompted.
Install in VS Code

​
Manual install

1

Create the MCP config file

At the root of your project, create .vscode/mcp.json:
{
  "servers": {
    "ordinal": {
      "type": "http",
      "url": "https://app.tryordinal.com/mcp"
    }
  }
}
2

Reload VS Code

Run the Developer: Reload Window command from the command palette (Cmd+Shift+P / Ctrl+Shift+P).
3

Sign in with Ordinal

The first time you use an Ordinal tool from Copilot Chat, VS Code opens a browser for sign-in. Authenticate with your Ordinal account and approve access.
4

Try it out

Open Copilot Chat in agent mode and ask: “List my Ordinal workspaces.” It should call the ordinal_get_workspace_context tool.

​
Troubleshooting

Make sure VS Code is registered as the handler for vscode:// URLs. On Windows and macOS, this happens on install; on Linux you may need to associate the scheme manually. If the button still fails, use the manual install steps above.
The one-click button targets stable VS Code. If you use Insiders, follow the manual install steps above — they work the same in both editions.
Open the MCP view in the sidebar and confirm ordinal shows as connected. If it says Sign in required, click it to run the OAuth flow.
You likely have the old server still configured. Remove any ordinal entry pointing at /api/mcp from .vscode/mcp.json (or your user-level settings.json). See the migration guide.