Remote MCP Scoped tokens Safe writes

Connect Startopia to coding agents and AI clients.

Startopia exposes project context, notes, tasks, recent changes, and preview-then-commit write actions through a remote MCP server. Use the built-in connect flow for client-specific install packs or wire it up directly from your agent.

Open connect flow Open manifest

Supported clients

These are the installation surfaces Startopia is packaging today for discovery and fast setup.

Claude Code

CLI-ready remote MCP setup for agentic coding and review loops.

Install surface: Startopia preset + project-scoped token
Official docs
Cursor

Repo-native MCP config plus one-click install links for fast onboarding.

Install surface: Cursor MCP config or deeplink
Official docs
Codex

Remote MCP setup with an exact `codex mcp add` command and TOML snippet.

Install surface: Codex CLI command or config.toml
Official docs
VS Code

Workspace-safe MCP config for Copilot agent mode with token prompts.

Install surface: .vscode/mcp.json
Official docs
Any MCP client

Fallback payload, smoke test, manifest link, and OpenAPI discovery links.

Install surface: Generic MCP JSON + curl smoke test
Official docs

Discovery URLs

These links are the public entry points you will use for listings, docs, and smoke tests.

Remote MCP endpoint
https://startopia.lol/mcp
Streamable HTTP endpoint for remote MCP clients.
Discovery manifest
https://startopia.lol/.well-known/startopia-ai.json
Machine-readable product and integration metadata.
OpenAPI schema
https://startopia.lol/openapi/integrations.json
REST companion schema for tools that ingest OpenAPI.
Connect flow
https://startopia.lol/integrations/connect/
Generate per-client install packs and scoped tokens after login.

Recommended setup path

Step 1

Create or reuse a project-scoped Startopia token.

Step 2

Pick a client preset or use the generic MCP payload.

Step 3

Call get_context_pack first so the agent starts with project context instead of raw notes.

Step 4

For writes, use preview_create_note, preview_create_task, or preview_update_task before commit_write_action.

Smoke test

Minimal remote MCP check

A project-scoped bearer token is enough to confirm the server is reachable and listing tools. 

curl -s https://startopia.lol/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <STARTOPIA_TOKEN>" \
  -H "MCP-Protocol-Version: 2025-06-18" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'