VS Code

VS Code signs in to Sallyport by itself. It reads MCP servers from your user configuration and from .vscode/mcp.json in the workspace.

Connect it

• Run “MCP: Open User Configuration” from the Command Palette and add the entry below.
• Start the sallyport server. VS Code asks to sign in and opens Sallyport in your browser.
• Sign in or create an account, then press “Allow” on the consent screen.

{
  "servers": {
    "sallyport": {
      "type": "http",
      "url": "https://mcp.sallyport.cloud/mcp"
    }
  }
}

Pressing “Allow” creates an agent named after the client. An owner’s or admin’s agent starts with every connection of the workspace. A member’s agent starts with none, and an admin adds them under “Access”. Signing in again later takes one “Reconnect” click.

Connect with a token

A token suits a project file that goes into git. An input asks for the token when the server first starts, and VS Code stores the answer securely.

• In the console, open Agents, press “New agent”, type a name and press “Create agent”.
• On the agent’s page, under “Tokens”, press “New token” and copy it. It is shown once.
• Save the file below as .vscode/mcp.json, start the sallyport server and paste the token when VS Code asks.

{
  "inputs": [
    {
      "type": "promptString",
      "id": "sallyport-token",
      "description": "Sallyport agent token",
      "password": true
    }
  ],
  "servers": {
    "sallyport": {
      "type": "http",
      "url": "https://mcp.sallyport.cloud/mcp",
      "headers": { "Authorization": "Bearer ${input:sallyport-token}" }
    }
  }
}

The file holds no secret, so it goes into git. Each developer pastes a token of their own, and the journal names the agent behind every call.

To have Sallyport in every workspace, run “MCP: Open User Configuration” from the Command Palette and add the same entry there.

When a call waits for a person

Calls run straight through unless you turned on “Ask every call” for a connection, set a class to “Approval required” or set a budget. Sallyport holds a waiting call for at most 4 minutes, and for at most 45 seconds if the client sends no progress token. Then it answers with approve_url and call_id.

Answer the card, then tell the agent to continue. It repeats the call with the same call_id and gets the result, so the service is called once.