MCP quickstart

Connect Claude Code, OpenAI Codex, or any Model Context Protocol (MCP) client to Juno’s hosted MCP server at https://api.heyjuno.co/v1/mcp/ using OAuth 2.1 or an API key, and run your first customer research tool call.

2 steps2 min read

First study

1. Connect client

# Connect with OAuth 2.1 (dynamic client registration + PKCE S256):
claude mcp add --transport http juno https://api.heyjuno.co/v1/mcp/

# Or configure a project .mcp.json using a Juno API key (jsk_live_… / jsk_test_…):
{
  "mcpServers": {
    "juno": {
      "type": "http",
      "url": "https://api.heyjuno.co/v1/mcp/",
      "headers": { "Authorization": "Bearer ${JUNO_API_KEY}" }
    }
  }
}

2. Create study

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "create_study",
    "arguments": {
      "guidance": "Interview churned customers about why they left"
    }
  }
}

// Returns: { "job_id": "run-7d1f22c8", "thread_id": "0b6a2f3e-9d41-4e6b-8a3f-2f6c1d9e4b7a" }

Previous API reference Next Concepts