# Connect to Question Relay over MCP

Server URL: https://questionrelay.com/mcp
Transport: Streamable HTTP. Auth: OAuth 2.1 with dynamic client registration
and PKCE — sign in with a Question Relay account when prompted; leave any
Client ID / Client Secret fields empty.

Tools: create_questionnaire, create_assumptions_review, get_results,
list_questionnaires, reissue_questionnaire.

## ChatGPT

No install link. Settings → Security and login → enable Developer mode →
chatgpt.com/plugins → + → name "Question Relay" → Connection: Public endpoint →
paste https://questionrelay.com/mcp → create → complete sign-in → enable
per-chat via + → More → Developer mode. Web app only; workspace plans need an
admin to allow developer mode.

## Claude (claude.ai, desktop, mobile)

Install link (opens the Add custom connector dialog prefilled):
https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Question%20Relay&connectorUrl=https%3A%2F%2Fquestionrelay.com%2Fmcp

Manual: Settings → Connectors → Add custom connector → name "Question Relay",
URL https://questionrelay.com/mcp → Connect → sign in → Allow.
Team/Enterprise: an org Owner must add it once under Organization settings →
Connectors. Free plans allow one custom connector.

## Claude Code

    claude mcp add --transport http question-relay https://questionrelay.com/mcp

Then run /mcp → question-relay → Authenticate (or: claude mcp login question-relay).
Project-scoped .mcp.json:

    { "mcpServers": { "question-relay": { "type": "http", "url": "https://questionrelay.com/mcp" } } }

Note: --transport http is required; in .mcp.json a url without "type": "http"
is a config error. Verify with: claude mcp list.

## Cursor

Install link:
https://cursor.com/install-mcp?name=question-relay&config=eyJ1cmwiOiJodHRwczovL3F1ZXN0aW9ucmVsYXkuY29tL21jcCJ9

Manual ~/.cursor/mcp.json:

    { "mcpServers": { "question-relay": { "url": "https://questionrelay.com/mcp" } } }

## VS Code (Copilot MCP)

Install link:
https://vscode.dev/redirect/mcp/install?name=question-relay&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fquestionrelay.com%2Fmcp%22%7D

Manual .vscode/mcp.json (key is "servers", not "mcpServers"):

    { "servers": { "question-relay": { "type": "http", "url": "https://questionrelay.com/mcp" } } }

CLI: code --add-mcp '{"name":"question-relay","type":"http","url":"https://questionrelay.com/mcp"}'

## Antigravity (Google)

~/.gemini/config/mcp_config.json (or .agents/mcp_config.json per workspace):

    { "mcpServers": { "question-relay": { "serverUrl": "https://questionrelay.com/mcp" } } }

Then Agent Settings → Customizations → Authenticate, and paste the returned
code back. Antigravity requires "serverUrl" — "url" and "httpUrl" are rejected.

## Any other client

Universal installer: npx add-mcp https://questionrelay.com/mcp
Generic config:

    { "mcpServers": { "question-relay": { "type": "http", "url": "https://questionrelay.com/mcp" } } }

Key-name exceptions: Windsurf uses serverUrl, VS Code uses servers, Zed uses
context_servers. Codex: codex mcp add question-relay --url
https://questionrelay.com/mcp, then codex mcp login question-relay.

Not yet connectable: the consumer Gemini app (partner connectors only) and
Gemini Enterprise (requires a manually issued OAuth client — contact
support@questionrelay.com).