[{"data":1,"prerenderedAt":794},["ShallowReactive",2],{"\u002Fblog\u002Fclaude-cursor-mcp-setup-guide":3},{"id":4,"title":5,"author":6,"body":8,"category":783,"date":784,"description":785,"extension":786,"faq":787,"howTo":787,"image":787,"lastUpdated":784,"meta":788,"navigation":789,"path":790,"readingTime":466,"seo":791,"stem":792,"__hash__":793},"blog\u002Fblog\u002Fclaude-cursor-mcp-setup-guide.md","Claude + Cursor MCP Setup Guide: API Key, Headers, mcp-remote, and Troubleshooting",{"name":7},"Theo Cummings",{"type":9,"value":10,"toc":764},"minimark",[11,24,27,38,41,47,56,61,64,77,84,88,91,106,109,121,124,128,131,185,188,193,201,207,326,329,332,337,344,347,353,494,497,501,504,528,534,541,545,550,553,568,571,584,588,590,598,600,611,615,617,622,624,632,636,638,643,645,653,660,664,667,684,687,691,694,732,736,739,760],[12,13,14,15,19,20,23],"p",{},"This guide shows the fastest path to a working ",[16,17,18],"strong",{},"Claude MCP setup"," and ",[16,21,22],{},"Cursor MCP setup"," with Vantaj.",[12,25,26],{},"You will connect to:",[28,29,35],"pre",{"className":30,"code":32,"language":33,"meta":34},[31],"language-text","https:\u002F\u002Fapi.vantaj.co\u002Fmcp\n","text","",[36,37,32],"code",{"__ignoreMap":34},[12,39,40],{},"You will authenticate with:",[28,42,45],{"className":43,"code":44,"language":33,"meta":34},[31],"Authorization: Bearer vtj_live_your_key\n",[36,46,44],{"__ignoreMap":34},[12,48,49,50,55],{},"For a strategic overview, read ",[51,52,54],"a",{"href":53},"\u002Fblog\u002Fmcp-monitoring-server-connect-claude-cursor","MCP Monitoring Server: Connect Claude and Cursor to Real Uptime Data",".",[57,58,60],"h2",{"id":59},"prerequisites","Prerequisites",[12,62,63],{},"Before setup, confirm three things:",[65,66,67,71,74],"ol",{},[68,69,70],"li",{},"You have a paid Vantaj plan with API access",[68,72,73],{},"You created an API key under Settings -> API Keys",[68,75,76],{},"Your key has the scopes you need",[12,78,79,80,55],{},"If you have not generated a key yet, follow ",[51,81,83],{"href":82},"\u002Fdocs\u002Fapi-keys","API keys",[57,85,87],{"id":86},"_1-claude-web-or-desktop-mcp-setup","1) Claude (Web or Desktop) MCP Setup",[12,89,90],{},"In Claude settings, add a custom connector.",[92,93,94,100],"ul",{},[68,95,96,97],{},"URL: ",[36,98,99],{},"https:\u002F\u002Fapi.vantaj.co\u002Fmcp",[68,101,102,103],{},"Header: ",[36,104,105],{},"Authorization: Bearer vtj_live_your_key",[12,107,108],{},"After saving, ask Claude:",[92,110,111,114],{},[68,112,113],{},"\"List my projects\"",[68,115,116,117,120],{},"\"List monitors for project ",[36,118,119],{},"\u003Cproject_id>","\"",[12,122,123],{},"If those calls work, auth and transport are configured.",[57,125,127],{"id":126},"_2-claude-code-mcp-setup","2) Claude Code MCP Setup",[12,129,130],{},"Use the CLI command:",[28,132,136],{"className":133,"code":134,"language":135,"meta":34,"style":34},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","claude mcp add --transport http vantaj https:\u002F\u002Fapi.vantaj.co\u002Fmcp \\\n  --header \"Authorization: Bearer vtj_live_your_key\"\n","bash",[36,137,138,170],{"__ignoreMap":34},[139,140,143,147,151,154,157,160,163,166],"span",{"class":141,"line":142},"line",1,[139,144,146],{"class":145},"sBMFI","claude",[139,148,150],{"class":149},"sfazB"," mcp",[139,152,153],{"class":149}," add",[139,155,156],{"class":149}," --transport",[139,158,159],{"class":149}," http",[139,161,162],{"class":149}," vantaj",[139,164,165],{"class":149}," https:\u002F\u002Fapi.vantaj.co\u002Fmcp",[139,167,169],{"class":168},"sTEyZ"," \\\n",[139,171,173,176,180,182],{"class":141,"line":172},2,[139,174,175],{"class":149},"  --header",[139,177,179],{"class":178},"sMK4o"," \"",[139,181,105],{"class":149},[139,183,184],{"class":178},"\"\n",[12,186,187],{},"Then test with a direct prompt in Claude Code:",[92,189,190],{},[68,191,192],{},"\"Use Vantaj MCP to list projects\"",[57,194,196,197,200],{"id":195},"_3-cursor-mcp-setup-cursormcpjson","3) Cursor MCP Setup (",[36,198,199],{},".cursor\u002Fmcp.json",")",[12,202,203,204,206],{},"Create or update ",[36,205,199],{},":",[28,208,212],{"className":209,"code":210,"language":211,"meta":34,"style":34},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"mcpServers\": {\n    \"vantaj\": {\n      \"url\": \"https:\u002F\u002Fapi.vantaj.co\u002Fmcp\",\n      \"headers\": { \"Authorization\": \"Bearer vtj_live_your_key\" }\n    }\n  }\n}\n","json",[36,213,214,219,235,250,273,308,314,320],{"__ignoreMap":34},[139,215,216],{"class":141,"line":142},[139,217,218],{"class":178},"{\n",[139,220,221,224,228,230,232],{"class":141,"line":172},[139,222,223],{"class":178},"  \"",[139,225,227],{"class":226},"spNyl","mcpServers",[139,229,120],{"class":178},[139,231,206],{"class":178},[139,233,234],{"class":178}," {\n",[139,236,238,241,244,246,248],{"class":141,"line":237},3,[139,239,240],{"class":178},"    \"",[139,242,243],{"class":145},"vantaj",[139,245,120],{"class":178},[139,247,206],{"class":178},[139,249,234],{"class":178},[139,251,253,256,260,262,264,266,268,270],{"class":141,"line":252},4,[139,254,255],{"class":178},"      \"",[139,257,259],{"class":258},"sbssI","url",[139,261,120],{"class":178},[139,263,206],{"class":178},[139,265,179],{"class":178},[139,267,99],{"class":149},[139,269,120],{"class":178},[139,271,272],{"class":178},",\n",[139,274,276,278,281,283,285,288,290,294,296,298,300,303,305],{"class":141,"line":275},5,[139,277,255],{"class":178},[139,279,280],{"class":258},"headers",[139,282,120],{"class":178},[139,284,206],{"class":178},[139,286,287],{"class":178}," {",[139,289,179],{"class":178},[139,291,293],{"class":292},"swJcz","Authorization",[139,295,120],{"class":178},[139,297,206],{"class":178},[139,299,179],{"class":178},[139,301,302],{"class":149},"Bearer vtj_live_your_key",[139,304,120],{"class":178},[139,306,307],{"class":178}," }\n",[139,309,311],{"class":141,"line":310},6,[139,312,313],{"class":178},"    }\n",[139,315,317],{"class":141,"line":316},7,[139,318,319],{"class":178},"  }\n",[139,321,323],{"class":141,"line":322},8,[139,324,325],{"class":178},"}\n",[12,327,328],{},"Restart Cursor after editing config.",[12,330,331],{},"Then test with:",[92,333,334],{},[68,335,336],{},"\"Use the vantaj MCP server and list projects\"",[57,338,340,341],{"id":339},"_4-local-only-mcp-clients-use-mcp-remote","4) Local-Only MCP Clients: Use ",[36,342,343],{},"mcp-remote",[12,345,346],{},"Some clients only support stdio servers.",[12,348,349,350,352],{},"Use ",[36,351,343],{}," as a bridge:",[28,354,356],{"className":209,"code":355,"language":211,"meta":34,"style":34},"{\n  \"mcpServers\": {\n    \"vantaj\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"mcp-remote\",\n        \"https:\u002F\u002Fapi.vantaj.co\u002Fmcp\",\n        \"--header\",\n        \"Authorization: Bearer vtj_live_your_key\"\n      ]\n    }\n  }\n}\n",[36,357,358,362,374,386,406,420,432,442,452,464,473,479,484,489],{"__ignoreMap":34},[139,359,360],{"class":141,"line":142},[139,361,218],{"class":178},[139,363,364,366,368,370,372],{"class":141,"line":172},[139,365,223],{"class":178},[139,367,227],{"class":226},[139,369,120],{"class":178},[139,371,206],{"class":178},[139,373,234],{"class":178},[139,375,376,378,380,382,384],{"class":141,"line":237},[139,377,240],{"class":178},[139,379,243],{"class":145},[139,381,120],{"class":178},[139,383,206],{"class":178},[139,385,234],{"class":178},[139,387,388,390,393,395,397,399,402,404],{"class":141,"line":252},[139,389,255],{"class":178},[139,391,392],{"class":258},"command",[139,394,120],{"class":178},[139,396,206],{"class":178},[139,398,179],{"class":178},[139,400,401],{"class":149},"npx",[139,403,120],{"class":178},[139,405,272],{"class":178},[139,407,408,410,413,415,417],{"class":141,"line":275},[139,409,255],{"class":178},[139,411,412],{"class":258},"args",[139,414,120],{"class":178},[139,416,206],{"class":178},[139,418,419],{"class":178}," [\n",[139,421,422,425,428,430],{"class":141,"line":310},[139,423,424],{"class":178},"        \"",[139,426,427],{"class":149},"-y",[139,429,120],{"class":178},[139,431,272],{"class":178},[139,433,434,436,438,440],{"class":141,"line":316},[139,435,424],{"class":178},[139,437,343],{"class":149},[139,439,120],{"class":178},[139,441,272],{"class":178},[139,443,444,446,448,450],{"class":141,"line":322},[139,445,424],{"class":178},[139,447,99],{"class":149},[139,449,120],{"class":178},[139,451,272],{"class":178},[139,453,455,457,460,462],{"class":141,"line":454},9,[139,456,424],{"class":178},[139,458,459],{"class":149},"--header",[139,461,120],{"class":178},[139,463,272],{"class":178},[139,465,467,469,471],{"class":141,"line":466},10,[139,468,424],{"class":178},[139,470,105],{"class":149},[139,472,184],{"class":178},[139,474,476],{"class":141,"line":475},11,[139,477,478],{"class":178},"      ]\n",[139,480,482],{"class":141,"line":481},12,[139,483,313],{"class":178},[139,485,487],{"class":141,"line":486},13,[139,488,319],{"class":178},[139,490,492],{"class":141,"line":491},14,[139,493,325],{"class":178},[12,495,496],{},"This keeps the remote hosted endpoint while satisfying local transport requirements.",[57,498,500],{"id":499},"_5-first-calls-to-validate-end-to-end-setup","5) First Calls to Validate End-to-End Setup",[12,502,503],{},"Run these in order:",[65,505,506,511,520],{},[68,507,508],{},[36,509,510],{},"list_projects",[68,512,513,516,517],{},[36,514,515],{},"list_monitors"," with a valid ",[36,518,519],{},"project_id",[68,521,522,525,526],{},[36,523,524],{},"list_incidents"," with the same ",[36,527,519],{},[12,529,530,531,533],{},"Why this order matters: most monitoring tools need a ",[36,532,519],{},", so discovery comes first.",[12,535,536,537,55],{},"For a full tool list, see ",[51,538,540],{"href":539},"\u002Fdocs\u002Fmcp-server","MCP server docs",[57,542,544],{"id":543},"common-mcp-setup-errors-and-fixes","Common MCP Setup Errors and Fixes",[546,547,549],"h3",{"id":548},"error-unauthorized-or-auth-failed","Error: unauthorized or auth failed",[12,551,552],{},"Cause:",[92,554,555,562,565],{},[68,556,557,558,561],{},"Missing ",[36,559,560],{},"Bearer "," prefix",[68,563,564],{},"Expired or revoked key",[68,566,567],{},"Typo in key value",[12,569,570],{},"Fix:",[92,572,573,578,581],{},[68,574,575,576],{},"Use exact header format from ",[51,577,83],{"href":82},[68,579,580],{},"Generate a new key if needed",[68,582,583],{},"Use a dedicated key per client so rotation is easy",[546,585,587],{"id":586},"error-no-tools-available","Error: no tools available",[12,589,552],{},[92,591,592,595],{},[68,593,594],{},"Client saved config in the wrong location",[68,596,597],{},"App did not reload config",[12,599,570],{},[92,601,602,605,608],{},[68,603,604],{},"Confirm path and JSON syntax",[68,606,607],{},"Restart the client",[68,609,610],{},"Re-run a simple discovery prompt: \"list projects\"",[546,612,614],{"id":613},"error-permission-denied-for-write-actions","Error: permission denied for write actions",[12,616,552],{},[92,618,619],{},[68,620,621],{},"Key has read-only scopes",[12,623,570],{},[92,625,626,629],{},[68,627,628],{},"Keep read-only for analysis workflows",[68,630,631],{},"Create a second key for controlled write workflows",[546,633,635],{"id":634},"error-expected-delete-tool-is-missing","Error: expected delete tool is missing",[12,637,552],{},[92,639,640],{},[68,641,642],{},"The MCP surface excludes destructive operations by design",[12,644,570],{},[92,646,647,650],{},[68,648,649],{},"Use dashboard or REST API for destructive actions",[68,651,652],{},"Keep MCP for reads and additive writes",[12,654,655,656,55],{},"For the full guardrail rationale, read ",[51,657,659],{"href":658},"\u002Fblog\u002Fmcp-server-security-ai-agents","How to Secure an MCP Server for AI Agents: Scopes, Limits, and Safe Tool Design",[57,661,663],{"id":662},"setup-patterns-that-scale-across-teams","Setup Patterns That Scale Across Teams",[12,665,666],{},"Use these defaults if you are rolling MCP across a team:",[92,668,669,672,675,678,681],{},[68,670,671],{},"One key per environment (dev, staging, prod)",[68,673,674],{},"One key per client type (Claude, Cursor, automation)",[68,676,677],{},"Read-only by default",[68,679,680],{},"Narrow write keys for monitor creation workflows",[68,682,683],{},"Quarterly key rotation",[12,685,686],{},"These patterns keep blast radius small and access auditable.",[57,688,690],{"id":689},"strong-internal-linking-for-this-topic-cluster","Strong Internal Linking for This Topic Cluster",[12,692,693],{},"If this post sits in your docs hub, link it to:",[92,695,696,703,708,713,719,725],{},[68,697,698,699],{},"Product page: ",[51,700,702],{"href":701},"\u002Fproducts\u002Fmcp-server","MCP Server",[68,704,705,706],{},"Documentation: ",[51,707,540],{"href":539},[68,709,710,711],{},"Auth model: ",[51,712,83],{"href":82},[68,714,715,716],{},"Strategy article: ",[51,717,718],{"href":53},"MCP Monitoring Server",[68,720,721,722],{},"Security article: ",[51,723,724],{"href":658},"MCP server security",[68,726,727,728],{},"Adjacent reliability article: ",[51,729,731],{"href":730},"\u002Fblog\u002Fmonitoring-llm-api","How to Monitor an LLM API",[57,733,735],{"id":734},"final-checklist","Final Checklist",[12,737,738],{},"If all boxes are true, your setup is production-ready:",[92,740,741,746,749,754,757],{},[68,742,743,744],{},"Endpoint set to ",[36,745,99],{},[68,747,748],{},"Header format is valid bearer auth",[68,750,751,753],{},[36,752,510],{}," succeeds",[68,755,756],{},"Scopes match intended actions",[68,758,759],{},"Team keys are segmented by use case",[761,762,763],"style",{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}",{"title":34,"searchDepth":172,"depth":172,"links":765},[766,767,768,769,771,773,774,780,781,782],{"id":59,"depth":172,"text":60},{"id":86,"depth":172,"text":87},{"id":126,"depth":172,"text":127},{"id":195,"depth":172,"text":770},"3) Cursor MCP Setup (.cursor\u002Fmcp.json)",{"id":339,"depth":172,"text":772},"4) Local-Only MCP Clients: Use mcp-remote",{"id":499,"depth":172,"text":500},{"id":543,"depth":172,"text":544,"children":775},[776,777,778,779],{"id":548,"depth":237,"text":549},{"id":586,"depth":237,"text":587},{"id":613,"depth":237,"text":614},{"id":634,"depth":237,"text":635},{"id":662,"depth":172,"text":663},{"id":689,"depth":172,"text":690},{"id":734,"depth":172,"text":735},"tutorials","2026-07-26","Step-by-step setup guide for connecting Claude, Claude Code, and Cursor to a hosted MCP server with API key headers, mcp-remote for local-only clients, and common fixes.","md",null,{},true,"\u002Fblog\u002Fclaude-cursor-mcp-setup-guide",{"title":5,"description":785},"blog\u002Fclaude-cursor-mcp-setup-guide","4jvbyPEgidFroiuIP70wP_PG5L8CkVtfPSiNqBF0NGI",1783707933288]