Skip to main content

Connect your client

You need two things:

Value
Server URLhttps://mcp.<your-domain>/mcp (local stack: http://localhost:4780/mcp or http://mcp.apps.localhost/mcp)
HeaderAuthorization: Bearer <token>. See Authentication.

The transport is Streamable HTTP ("type": "http" in most clients).

Availability

Until OAuth ships, only clients that let you send a custom header connect directly. The examples below use the local dev token (dev-token, or dev-token:<email> to act as someone else).

Claude​

claude mcp add --transport http vastframe https://mcp.<your-domain>/mcp \
--header "Authorization: Bearer dev-token"

Add --scope project to write it into the repository's .mcp.json so your whole team gets it. Check it with claude mcp list, or /mcp inside a session.

Local stack:

claude mcp add --transport http vastframe http://localhost:4780/mcp \
--header "Authorization: Bearer dev-token"

GitHub Copilot​

Create .vscode/mcp.json in your workspace (or run MCP: Add Server from the command palette):

.vscode/mcp.json
{
"inputs": [
{ "type": "promptString", "id": "vf-token", "description": "vastframe token", "password": true }
],
"servers": {
"vastframe": {
"type": "http",
"url": "https://mcp.<your-domain>/mcp",
"headers": { "Authorization": "Bearer ${input:vf-token}" }
}
}
}

Open Copilot Chat in Agent mode and pick the vastframe tools from the tools menu.

note

In organizations on Copilot Business or Enterprise, an admin must enable the "MCP servers in Copilot" policy first.

Other MCP clients​

Any client that supports remote MCP over Streamable HTTP with custom headers works. For example, Cursor:

~/.cursor/mcp.json
{
"mcpServers": {
"vastframe": {
"url": "https://mcp.<your-domain>/mcp",
"headers": { "Authorization": "Bearer dev-token" }
}
}
}

Clients that only speak stdio can use the mcp-remote bridge shown in the Claude Desktop tab.

Check the connection​

Ask your agent:

Call the vastframe whoami tool.

It should answer with your name and the platform version. If you get 401 unauthorized, the token is missing or wrong.

Teach the agent the SDK​

The server tells clients to call get_docs before writing app code. To make it stick, paste the AGENTS.md snippet into your repository: ask the agent to "call get_docs with topic agents and add the snippet to CLAUDE.md" (or AGENTS.md, or .github/copilot-instructions.md).

Was this page helpful?