MCP Setup Guide

Step-by-step instructions for connecting Claude Desktop to your Person CRUD MCP server.

1) Configure MCP API Key

Set MCP_API_KEY in this Next.js app environment and redeploy.

# .env.local or Vercel env
MCP_API_KEY=your_same_mcp_api_key
NEXT_PUBLIC_APP_BASE_URL=https://person-search-siddayao.vercel.app
2) Point Claude Desktop to /api/mcp

Recommended for Claude Desktop: use mcp-remote bridge config.

{
  "mcpServers": {
    "person-crud": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://person-search-siddayao.vercel.app/api/mcp",
        "--header",
        "x-mcp-api-key:your_same_mcp_api_key"
      ]
    }
  }
}

Optional fallback (only if your Claude build supports direct streamable HTTP transport):

{
  "mcpServers": {
    "person-crud": {
      "transport": "streamable-http",
      "url": "https://person-search-siddayao.vercel.app/api/mcp",
      "headers": {
        "x-mcp-api-key": "your_same_mcp_api_key"
      }
    }
  }
}
3) Verify Tool Availability

After connecting, run tools/list and confirm these CRUD tools appear.

Available MCP tools:
- person_create(name, email, phoneNumber)
- person_list(query?)
- person_get(id)
- person_update(id, name?, email?, phoneNumber?)
- person_delete(id)
4) Test CRUD End-to-End

Run these checks:

  • Create person via Claude Desktop tool call.
  • List/search person and confirm record exists.
  • Update person fields and verify persisted values.
  • Delete person and confirm it no longer appears in list results.

Use the in-app live tester at /mcp-demo for evaluator-visible request logs and JSON responses.

5) Screenshot Evidence

Add screenshots to your repository for evaluator review:

  • Claude Desktop running person_create
  • Claude Desktop running person_get or person_list
  • Claude Desktop running person_update
  • Claude Desktop running person_delete