SpyBara
Go Premium

Documentation 2025-11-19 03:21 UTC to 2025-11-20 18:02 UTC

10 files changed +50 −636. View all changes and history on the product overview
2025
Thu 27 06:02 Wed 26 00:04 Tue 25 03:22 Mon 24 21:01 Fri 21 00:04 Thu 20 18:02 Wed 19 03:21 Tue 18 18:02 Mon 17 03:24 Sun 16 00:04 Fri 14 21:26 Thu 6 18:02 Tue 4 18:02 Mon 3 21:01 Sun 2 18:01 Sat 1 21:01

hooks.md +5 −3

Details

38```38```

39 39 

40* **matcher**: Pattern to match tool names, case-sensitive (only applicable for40* **matcher**: Pattern to match tool names, case-sensitive (only applicable for

41 `PreToolUse` and `PostToolUse`)41 `PreToolUse`, `PermissionRequest`, and `PostToolUse`)

42 * Simple strings match exactly: `Write` matches only the Write tool42 * Simple strings match exactly: `Write` matches only the Write tool

43 * Supports regex: `Edit|Write` or `Notebook.*`43 * Supports regex: `Edit|Write` or `Notebook.*`

44 * Use `*` to match all tools. You can also use empty string (`""`) or leave44 * Use `*` to match all tools. You can also use empty string (`""`) or leave


211* **SubagentStop**: Evaluate if a subagent has completed its task211* **SubagentStop**: Evaluate if a subagent has completed its task

212* **UserPromptSubmit**: Validate user prompts with LLM assistance212* **UserPromptSubmit**: Validate user prompts with LLM assistance

213* **PreToolUse**: Make context-aware permission decisions213* **PreToolUse**: Make context-aware permission decisions

214* **PermissionRequest**: Intelligently allow or deny permission dialogs

214 215 

215### Example: Intelligent Stop hook216### Example: Intelligent Stop hook

216 217 


616#### Exit Code 2 Behavior617#### Exit Code 2 Behavior

617 618 

618| Hook Event | Behavior |619| Hook Event | Behavior |

619| ------------------ | ------------------------------------------------------------------ |620| ------------------- | ------------------------------------------------------------------ |

620| `PreToolUse` | Blocks the tool call, shows stderr to Claude |621| `PreToolUse` | Blocks the tool call, shows stderr to Claude |

622| `PermissionRequest` | Denies the permission, shows stderr to Claude |

621| `PostToolUse` | Shows stderr to Claude (tool already ran) |623| `PostToolUse` | Shows stderr to Claude (tool already ran) |

622| `Notification` | N/A, shows stderr to user only |624| `Notification` | N/A, shows stderr to user only |

623| `UserPromptSubmit` | Blocks prompt processing, erases prompt, shows stderr to user only |625| `UserPromptSubmit` | Blocks prompt processing, erases prompt, shows stderr to user only |


1070 * The `CLAUDE_CODE_REMOTE` environment variable indicates whether the hook is running in a remote (web) environment (`"true"`) or local CLI environment (not set or empty). Use this to run different logic based on execution context.1072 * The `CLAUDE_CODE_REMOTE` environment variable indicates whether the hook is running in a remote (web) environment (`"true"`) or local CLI environment (not set or empty). Use this to run different logic based on execution context.

1071* **Input**: JSON via stdin1073* **Input**: JSON via stdin

1072* **Output**:1074* **Output**:

1073 * PreToolUse/PostToolUse/Stop/SubagentStop: Progress shown in verbose mode (ctrl+o)1075 * PreToolUse/PermissionRequest/PostToolUse/Stop/SubagentStop: Progress shown in verbose mode (ctrl+o)

1074 * Notification/SessionEnd: Logged to debug only (`--debug`)1076 * Notification/SessionEnd: Logged to debug only (`--debug`)

1075 * UserPromptSubmit/SessionStart: stdout added as context for Claude1077 * UserPromptSubmit/SessionStart: stdout added as context for Claude

1076 1078 

hooks-guide.md +1 −0

Details

40workflow:40workflow:

41 41 

42* **PreToolUse**: Runs before tool calls (can block them)42* **PreToolUse**: Runs before tool calls (can block them)

43* **PermissionRequest**: Runs when a permission dialog is shown (can allow or deny)

43* **PostToolUse**: Runs after tool calls complete44* **PostToolUse**: Runs after tool calls complete

44* **UserPromptSubmit**: Runs when the user submits a prompt, before Claude processes it45* **UserPromptSubmit**: Runs when the user submits a prompt, before Claude processes it

45* **Notification**: Runs when Claude Code sends notifications46* **Notification**: Runs when Claude Code sends notifications

iam.md +2 −2

Details

8 8 

9* Claude API via the Claude Console9* Claude API via the Claude Console

10* Amazon Bedrock10* Amazon Bedrock

11* Azure AI Foundry11* Microsoft Foundry

12* Google Vertex AI12* Google Vertex AI

13 13 

14### Claude API authentication14### Claude API authentication


32 32 

33**To set up Claude Code access for your team via Bedrock, Vertex, or Azure:**33**To set up Claude Code access for your team via Bedrock, Vertex, or Azure:**

34 34 

351. Follow the [Bedrock docs](/en/amazon-bedrock), [Vertex docs](/en/google-vertex-ai), or [Azure AI Foundry docs](/en/azure-ai-foundry)351. Follow the [Bedrock docs](/en/amazon-bedrock), [Vertex docs](/en/google-vertex-ai), or [Microsoft Foundry docs](/en/microsoft-foundry)

362. Distribute the environment variables and instructions for generating cloud credentials to your users. Read more about how to [manage configuration here](/en/settings).362. Distribute the environment variables and instructions for generating cloud credentials to your users. Read more about how to [manage configuration here](/en/settings).

373. Users can [install Claude Code](/en/setup#installation)373. Users can [install Claude Code](/en/setup#installation)

38 38 

mcp.md +0 −590

Details

2 2 

3> Learn how to connect Claude Code to your tools with the Model Context Protocol.3> Learn how to connect Claude Code to your tools with the Model Context Protocol.

4 4 

5export const MCPServersTable = ({platform = "all"}) => {

6 const generateClaudeCodeCommand = server => {

7 if (server.customCommands && server.customCommands.claudeCode) {

8 return server.customCommands.claudeCode;

9 }

10 if (server.urls.http) {

11 return `claude mcp add --transport http ${server.name.toLowerCase().replace(/[^a-z0-9]/g, '-')} ${server.urls.http}`;

12 }

13 if (server.urls.sse) {

14 return `claude mcp add --transport sse ${server.name.toLowerCase().replace(/[^a-z0-9]/g, '-')} ${server.urls.sse}`;

15 }

16 if (server.urls.stdio) {

17 const envFlags = server.authentication && server.authentication.envVars ? server.authentication.envVars.map(v => `--env ${v}=YOUR_${v.split('_').pop()}`).join(' ') : '';

18 const baseCommand = `claude mcp add --transport stdio ${server.name.toLowerCase().replace(/[^a-z0-9]/g, '-')}`;

19 return envFlags ? `${baseCommand} ${envFlags} -- ${server.urls.stdio}` : `${baseCommand} -- ${server.urls.stdio}`;

20 }

21 return null;

22 };

23 const servers = [{

24 name: "Airtable",

25 category: "Databases & Data Management",

26 description: "Read/write records, manage bases and tables",

27 documentation: "https://github.com/domdomegg/airtable-mcp-server",

28 urls: {

29 stdio: "npx -y airtable-mcp-server"

30 },

31 authentication: {

32 type: "api_key",

33 envVars: ["AIRTABLE_API_KEY"]

34 },

35 availability: {

36 claudeCode: true,

37 mcpConnector: false,

38 claudeDesktop: true

39 }

40 }, {

41 name: "Figma",

42 category: "Design & Media",

43 description: "Generate better code by bringing in full Figma context",

44 documentation: "https://developers.figma.com",

45 urls: {

46 http: "https://mcp.figma.com/mcp"

47 },

48 customCommands: {

49 claudeCode: "claude mcp add --transport http figma-remote-mcp https://mcp.figma.com/mcp"

50 },

51 availability: {

52 claudeCode: true,

53 mcpConnector: false,

54 claudeDesktop: false

55 },

56 notes: "Visit developers.figma.com for local server setup."

57 }, {

58 name: "Asana",

59 category: "Project Management & Documentation",

60 description: "Interact with your Asana workspace to keep projects on track",

61 documentation: "https://developers.asana.com/docs/using-asanas-model-control-protocol-mcp-server",

62 urls: {

63 sse: "https://mcp.asana.com/sse"

64 },

65 authentication: {

66 type: "oauth"

67 },

68 availability: {

69 claudeCode: true,

70 mcpConnector: true,

71 claudeDesktop: false

72 }

73 }, {

74 name: "Atlassian",

75 category: "Project Management & Documentation",

76 description: "Manage your Jira tickets and Confluence docs",

77 documentation: "https://www.atlassian.com/platform/remote-mcp-server",

78 urls: {

79 sse: "https://mcp.atlassian.com/v1/sse"

80 },

81 authentication: {

82 type: "oauth"

83 },

84 availability: {

85 claudeCode: true,

86 mcpConnector: true,

87 claudeDesktop: false

88 }

89 }, {

90 name: "ClickUp",

91 category: "Project Management & Documentation",

92 description: "Task management, project tracking",

93 documentation: "https://github.com/hauptsacheNet/clickup-mcp",

94 urls: {

95 stdio: "npx -y @hauptsache.net/clickup-mcp"

96 },

97 authentication: {

98 type: "api_key",

99 envVars: ["CLICKUP_API_KEY", "CLICKUP_TEAM_ID"]

100 },

101 availability: {

102 claudeCode: true,

103 mcpConnector: false,

104 claudeDesktop: true

105 }

106 }, {

107 name: "Cloudflare",

108 category: "Infrastructure & DevOps",

109 description: "Build applications, analyze traffic, monitor performance, and manage security settings through Cloudflare",

110 documentation: "https://developers.cloudflare.com/agents/model-context-protocol/mcp-servers-for-cloudflare/",

111 urls: {},

112 availability: {

113 claudeCode: true,

114 mcpConnector: true,

115 claudeDesktop: false

116 },

117 notes: "Multiple services available. See documentation for specific server URLs. Claude Code can use the Cloudflare CLI if installed."

118 }, {

119 name: "Cloudinary",

120 category: "Design & Media",

121 description: "Upload, manage, transform, and analyze your media assets",

122 documentation: "https://cloudinary.com/documentation/cloudinary_llm_mcp#mcp_servers",

123 urls: {},

124 authentication: {

125 type: "oauth"

126 },

127 availability: {

128 claudeCode: true,

129 mcpConnector: true,

130 claudeDesktop: false

131 },

132 notes: "Multiple services available. See documentation for specific server URLs."

133 }, {

134 name: "Intercom",

135 category: "Project Management & Documentation",

136 description: "Access real-time customer conversations, tickets, and user data",

137 documentation: "https://developers.intercom.com/docs/guides/mcp",

138 urls: {

139 http: "https://mcp.intercom.com/mcp"

140 },

141 authentication: {

142 type: "oauth"

143 },

144 availability: {

145 claudeCode: true,

146 mcpConnector: true,

147 claudeDesktop: false

148 }

149 }, {

150 name: "invideo",

151 category: "Design & Media",

152 description: "Build video creation capabilities into your applications",

153 documentation: "https://invideo.io/ai/mcp",

154 urls: {

155 sse: "https://mcp.invideo.io/sse"

156 },

157 authentication: {

158 type: "oauth"

159 },

160 availability: {

161 claudeCode: true,

162 mcpConnector: true,

163 claudeDesktop: false

164 }

165 }, {

166 name: "Linear",

167 category: "Project Management & Documentation",

168 description: "Integrate with Linear's issue tracking and project management",

169 documentation: "https://linear.app/docs/mcp",

170 urls: {

171 http: "https://mcp.linear.app/mcp"

172 },

173 authentication: {

174 type: "oauth"

175 },

176 availability: {

177 claudeCode: true,

178 mcpConnector: true,

179 claudeDesktop: false

180 }

181 }, {

182 name: "Notion",

183 category: "Project Management & Documentation",

184 description: "Read docs, update pages, manage tasks",

185 documentation: "https://developers.notion.com/docs/mcp",

186 urls: {

187 http: "https://mcp.notion.com/mcp"

188 },

189 authentication: {

190 type: "oauth"

191 },

192 availability: {

193 claudeCode: true,

194 mcpConnector: false,

195 claudeDesktop: false

196 }

197 }, {

198 name: "PayPal",

199 category: "Payments & Commerce",

200 description: "Integrate PayPal commerce capabilities, payment processing, transaction management",

201 documentation: "https://www.paypal.ai/",

202 urls: {

203 http: "https://mcp.paypal.com/mcp"

204 },

205 authentication: {

206 type: "oauth"

207 },

208 availability: {

209 claudeCode: true,

210 mcpConnector: true,

211 claudeDesktop: false

212 }

213 }, {

214 name: "Plaid",

215 category: "Payments & Commerce",

216 description: "Analyze, troubleshoot, and optimize Plaid integrations. Banking data, financial account linking",

217 documentation: "https://plaid.com/blog/plaid-mcp-ai-assistant-claude/",

218 urls: {

219 sse: "https://api.dashboard.plaid.com/mcp/sse"

220 },

221 authentication: {

222 type: "oauth"

223 },

224 availability: {

225 claudeCode: true,

226 mcpConnector: true,

227 claudeDesktop: false

228 }

229 }, {

230 name: "Sentry",

231 category: "Development & Testing Tools",

232 description: "Monitor errors, debug production issues",

233 documentation: "https://docs.sentry.io/product/sentry-mcp/",

234 urls: {

235 http: "https://mcp.sentry.dev/mcp"

236 },

237 authentication: {

238 type: "oauth"

239 },

240 availability: {

241 claudeCode: true,

242 mcpConnector: false,

243 claudeDesktop: false

244 }

245 }, {

246 name: "Square",

247 category: "Payments & Commerce",

248 description: "Use an agent to build on Square APIs. Payments, inventory, orders, and more",

249 documentation: "https://developer.squareup.com/docs/mcp",

250 urls: {

251 sse: "https://mcp.squareup.com/sse"

252 },

253 authentication: {

254 type: "oauth"

255 },

256 availability: {

257 claudeCode: true,

258 mcpConnector: true,

259 claudeDesktop: false

260 }

261 }, {

262 name: "Socket",

263 category: "Development & Testing Tools",

264 description: "Security analysis for dependencies",

265 documentation: "https://github.com/SocketDev/socket-mcp",

266 urls: {

267 http: "https://mcp.socket.dev/"

268 },

269 authentication: {

270 type: "oauth"

271 },

272 availability: {

273 claudeCode: true,

274 mcpConnector: false,

275 claudeDesktop: false

276 }

277 }, {

278 name: "Stripe",

279 category: "Payments & Commerce",

280 description: "Payment processing, subscription management, and financial transactions",

281 documentation: "https://docs.stripe.com/mcp",

282 urls: {

283 http: "https://mcp.stripe.com"

284 },

285 authentication: {

286 type: "oauth"

287 },

288 availability: {

289 claudeCode: true,

290 mcpConnector: true,

291 claudeDesktop: false

292 }

293 }, {

294 name: "Workato",

295 category: "Automation & Integration",

296 description: "Access any application, workflows or data via Workato, made accessible for AI",

297 documentation: "https://docs.workato.com/mcp.html",

298 urls: {},

299 availability: {

300 claudeCode: true,

301 mcpConnector: true,

302 claudeDesktop: false

303 },

304 notes: "MCP servers are programmatically generated"

305 }, {

306 name: "Zapier",

307 category: "Automation & Integration",

308 description: "Connect to nearly 8,000 apps through Zapier's automation platform",

309 documentation: "https://help.zapier.com/hc/en-us/articles/36265392843917",

310 urls: {},

311 availability: {

312 claudeCode: true,

313 mcpConnector: true,

314 claudeDesktop: false

315 },

316 notes: "Generate a user-specific URL at mcp.zapier.com"

317 }, {

318 name: "Box",

319 category: "Project Management & Documentation",

320 description: "Ask questions about your enterprise content, get insights from unstructured data, automate content workflows",

321 documentation: "https://box.dev/guides/box-mcp/remote/",

322 urls: {

323 http: "https://mcp.box.com/"

324 },

325 authentication: {

326 type: "oauth"

327 },

328 availability: {

329 claudeCode: true,

330 mcpConnector: true,

331 claudeDesktop: false

332 }

333 }, {

334 name: "Canva",

335 category: "Design & Media",

336 description: "Browse, summarize, autofill, and even generate new Canva designs directly from Claude",

337 documentation: "https://www.canva.dev/docs/connect/canva-mcp-server-setup/",

338 urls: {

339 http: "https://mcp.canva.com/mcp"

340 },

341 authentication: {

342 type: "oauth"

343 },

344 availability: {

345 claudeCode: true,

346 mcpConnector: true,

347 claudeDesktop: false

348 }

349 }, {

350 name: "Daloopa",

351 category: "Databases & Data Management",

352 description: "Supplies high quality fundamental financial data sourced from SEC Filings, investor presentations",

353 documentation: "https://docs.daloopa.com/docs/daloopa-mcp",

354 urls: {

355 http: "https://mcp.daloopa.com/server/mcp"

356 },

357 authentication: {

358 type: "oauth"

359 },

360 availability: {

361 claudeCode: true,

362 mcpConnector: true,

363 claudeDesktop: false

364 }

365 }, {

366 name: "Fireflies",

367 category: "Project Management & Documentation",

368 description: "Extract valuable insights from meeting transcripts and summaries",

369 documentation: "https://guide.fireflies.ai/articles/8272956938-learn-about-the-fireflies-mcp-server-model-context-protocol",

370 urls: {

371 http: "https://api.fireflies.ai/mcp"

372 },

373 authentication: {

374 type: "oauth"

375 },

376 availability: {

377 claudeCode: true,

378 mcpConnector: true,

379 claudeDesktop: false

380 }

381 }, {

382 name: "HubSpot",

383 category: "Databases & Data Management",

384 description: "Access and manage HubSpot CRM data by fetching contacts, companies, and deals, and creating and updating records",

385 documentation: "https://developers.hubspot.com/mcp",

386 urls: {

387 http: "https://mcp.hubspot.com/anthropic"

388 },

389 authentication: {

390 type: "oauth"

391 },

392 availability: {

393 claudeCode: true,

394 mcpConnector: true,

395 claudeDesktop: false

396 }

397 }, {

398 name: "Hugging Face",

399 category: "Development & Testing Tools",

400 description: "Provides access to Hugging Face Hub information and Gradio AI Applications",

401 documentation: "https://huggingface.co/settings/mcp",

402 urls: {

403 http: "https://huggingface.co/mcp"

404 },

405 authentication: {

406 type: "oauth"

407 },

408 availability: {

409 claudeCode: true,

410 mcpConnector: true,

411 claudeDesktop: false

412 }

413 }, {

414 name: "Jam",

415 category: "Development & Testing Tools",

416 description: "Debug faster with AI agents that can access Jam recordings like video, console logs, network requests, and errors",

417 documentation: "https://jam.dev/docs/debug-a-jam/mcp",

418 urls: {

419 http: "https://mcp.jam.dev/mcp"

420 },

421 authentication: {

422 type: "oauth"

423 },

424 availability: {

425 claudeCode: true,

426 mcpConnector: true,

427 claudeDesktop: false

428 }

429 }, {

430 name: "Monday",

431 category: "Project Management & Documentation",

432 description: "Manage monday.com boards by creating items, updating columns, assigning owners, setting timelines, adding CRM activities, and writing summaries",

433 documentation: "https://developer.monday.com/apps/docs/mondaycom-mcp-integration",

434 urls: {

435 http: "https://mcp.monday.com/mcp"

436 },

437 authentication: {

438 type: "oauth"

439 },

440 availability: {

441 claudeCode: true,

442 mcpConnector: true,

443 claudeDesktop: false

444 }

445 }, {

446 name: "Netlify",

447 category: "Infrastructure & DevOps",

448 description: "Create, deploy, and manage websites on Netlify. Control all aspects of your site from creating secrets to enforcing access controls to aggregating form submissions",

449 documentation: "https://docs.netlify.com/build/build-with-ai/netlify-mcp-server/",

450 urls: {

451 http: "https://netlify-mcp.netlify.app/mcp"

452 },

453 authentication: {

454 type: "oauth"

455 },

456 availability: {

457 claudeCode: true,

458 mcpConnector: true,

459 claudeDesktop: false

460 }

461 }, {

462 name: "Stytch",

463 category: "Infrastructure & DevOps",

464 description: "Configure and manage Stytch authentication services, redirect URLs, email templates, and workspace settings",

465 documentation: "https://stytch.com/docs/workspace-management/stytch-mcp",

466 urls: {

467 http: "http://mcp.stytch.dev/mcp"

468 },

469 authentication: {

470 type: "oauth"

471 },

472 availability: {

473 claudeCode: true,

474 mcpConnector: true,

475 claudeDesktop: false

476 }

477 }, {

478 name: "Vercel",

479 category: "Infrastructure & DevOps",

480 description: "Vercel's official MCP server, allowing you to search and navigate documentation, manage projects and deployments, and analyze deployment logs—all in one place",

481 documentation: "https://vercel.com/docs/mcp/vercel-mcp",

482 urls: {

483 http: "https://mcp.vercel.com/"

484 },

485 authentication: {

486 type: "oauth"

487 },

488 availability: {

489 claudeCode: true,

490 mcpConnector: true,

491 claudeDesktop: false

492 }

493 }];

494 const filteredServers = servers.filter(server => {

495 if (platform === "claudeCode") {

496 return server.availability.claudeCode;

497 } else if (platform === "mcpConnector") {

498 return server.availability.mcpConnector;

499 } else if (platform === "claudeDesktop") {

500 return server.availability.claudeDesktop;

501 } else if (platform === "all") {

502 return true;

503 } else {

504 throw new Error(`Unknown platform: ${platform}`);

505 }

506 });

507 const serversByCategory = filteredServers.reduce((acc, server) => {

508 if (!acc[server.category]) {

509 acc[server.category] = [];

510 }

511 acc[server.category].push(server);

512 return acc;

513 }, {});

514 const categoryOrder = ["Development & Testing Tools", "Project Management & Documentation", "Databases & Data Management", "Payments & Commerce", "Design & Media", "Infrastructure & DevOps", "Automation & Integration"];

515 return <>

516 <style jsx>{`

517 .cards-container {

518 display: grid;

519 gap: 1rem;

520 margin-bottom: 2rem;

521 }

522 .server-card {

523 border: 1px solid var(--border-color, #e5e7eb);

524 border-radius: 6px;

525 padding: 1rem;

526 }

527 .command-row {

528 display: flex;

529 align-items: center;

530 gap: 0.25rem;

531 }

532 .command-row code {

533 font-size: 0.75rem;

534 overflow-x: auto;

535 }

536 `}</style>

537

538 {categoryOrder.map(category => {

539 if (!serversByCategory[category]) return null;

540 return <div key={category}>

541 <h3>{category}</h3>

542 <div className="cards-container">

543 {serversByCategory[category].map(server => {

544 const claudeCodeCommand = generateClaudeCodeCommand(server);

545 const mcpUrl = server.urls.http || server.urls.sse;

546 const commandToShow = platform === "claudeCode" ? claudeCodeCommand : mcpUrl;

547 return <div key={server.name} className="server-card">

548 <div>

549 {server.documentation ? <a href={server.documentation}>

550 <strong>{server.name}</strong>

551 </a> : <strong>{server.name}</strong>}

552 </div>

553

554 <p style={{

555 margin: '0.5rem 0',

556 fontSize: '0.9rem'

557 }}>

558 {server.description}

559 {server.notes && <span style={{

560 display: 'block',

561 marginTop: '0.25rem',

562 fontSize: '0.8rem',

563 fontStyle: 'italic',

564 opacity: 0.7

565 }}>

566 {server.notes}

567 </span>}

568 </p>

569

570 {commandToShow && <>

571 <p style={{

572 display: 'block',

573 fontSize: '0.75rem',

574 fontWeight: 500,

575 minWidth: 'fit-content',

576 marginTop: '0.5rem',

577 marginBottom: 0

578 }}>

579 {platform === "claudeCode" ? "Command" : "URL"}

580 </p>

581 <div className="command-row">

582 <code>

583 {commandToShow}

584 </code>

585 </div>

586 </>}

587 </div>;

588 })}

589 </div>

590 </div>;

591 })}

592 </>;

593};

594 

595Claude Code can connect to hundreds of external tools and data sources through the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction), an open-source standard for AI-tool integrations. MCP servers give Claude Code access to your tools, databases, and APIs.5Claude Code can connect to hundreds of external tools and data sources through the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction), an open-source standard for AI-tool integrations. MCP servers give Claude Code access to your tools, databases, and APIs.

596 6 

597## What you can do with MCP7## What you can do with MCP

microsoft-foundry.md +17 −17 renamed

Details

Previously: azure-ai-foundry.md

1# Claude Code on Azure AI Foundry1# Claude Code on Microsoft Foundry

2 2 

3> Learn about configuring Claude Code through Azure AI Foundry, including setup, configuration, and troubleshooting.3> Learn about configuring Claude Code through Microsoft Foundry, including setup, configuration, and troubleshooting.

4 4 

5## Prerequisites5## Prerequisites

6 6 

7Before configuring Claude Code with Azure AI Foundry, ensure you have:7Before configuring Claude Code with Microsoft Foundry, ensure you have:

8 8 

9* An Azure subscription with access to Azure AI Foundry9* An Azure subscription with access to Microsoft Foundry

10* RBAC permissions to create Azure AI Foundry resources and deployments10* RBAC permissions to create Microsoft Foundry resources and deployments

11* Azure CLI installed and configured (optional - only needed if you dont have another mechanism for getting credentials)11* Azure CLI installed and configured (optional - only needed if you don't have another mechanism for getting credentials)

12 12 

13## Setup13## Setup

14 14 

15### 1. Provision Azure AI Foundry resource15### 1. Provision Microsoft Foundry resource

16 16 

17First, create a Claude resource in Azure:17First, create a Claude resource in Azure:

18 18 

191. Navigate to the [Azure AI Foundry portal](https://ai.azure.com/)191. Navigate to the [Microsoft Foundry portal](https://ai.azure.com/)

202. Create a new resource, noting your resource name202. Create a new resource, noting your resource name

213. Create deployments for the Claude models:213. Create deployments for the Claude models:

22 * Claude Opus22 * Claude Opus


25 25 

26### 2. Configure Azure credentials26### 2. Configure Azure credentials

27 27 

28Claude Code supports two authentication methods for Azure AI Foundry. Choose the method that best fits your security requirements.28Claude Code supports two authentication methods for Microsoft Foundry. Choose the method that best fits your security requirements.

29 29 

30**Option A: API key authentication**30**Option A: API key authentication**

31 31 

321. Navigate to your resource in the Azure AI Foundry portal321. Navigate to your resource in the Microsoft Foundry portal

332. Go to the **Endpoints and keys** section332. Go to the **Endpoints and keys** section

343. Copy **API Key**343. Copy **API Key**

354. Set the environment variable:354. Set the environment variable:


50```50```

51 51 

52<Note>52<Note>

53 When using AI Foundry, the `/login` and `/logout` commands are disabled since authentication is handled through Azure credentials.53 When using Microsoft Foundry, the `/login` and `/logout` commands are disabled since authentication is handled through Azure credentials.

54</Note>54</Note>

55 55 

56### 3. Configure Claude Code56### 3. Configure Claude Code

57 57 

58Set the following environment variables to enable Azure AI Foundry. Note that your deployments' names are set as the model identifiers in Claude Code (may be optional if using suggested deployment names).58Set the following environment variables to enable Microsoft Foundry. Note that your deployments' names are set as the model identifiers in Claude Code (may be optional if using suggested deployment names).

59 59 

60```bash theme={null}60```bash theme={null}

61# Enable Azure AI Foundry integration61# Enable Microsoft Foundry integration

62export CLAUDE_CODE_USE_FOUNDRY=162export CLAUDE_CODE_USE_FOUNDRY=1

63 63 

64# Azure resource name (replace {resource} with your resource name)64# Azure resource name (replace {resource} with your resource name)


92}92}

93```93```

94 94 

95For details, see [Azure AI Foundry RBAC documentation](https://learn.microsoft.com/en-us/azure/ai-foundry/concepts/rbac-azure-ai-foundry).95For details, see [Microsoft Foundry RBAC documentation](https://learn.microsoft.com/en-us/azure/ai-foundry/concepts/rbac-azure-ai-foundry).

96 96 

97## Troubleshooting97## Troubleshooting

98 98 


102 102 

103## Additional resources103## Additional resources

104 104 

105* [AI Foundry documentation](https://learn.microsoft.com/en-us/azure/ai-foundry/what-is-azure-ai-foundry)105* [Microsoft Foundry documentation](https://learn.microsoft.com/en-us/azure/ai-foundry/what-is-azure-ai-foundry)

106* [AI Foundry models](https://ai.azure.com/explore/models)106* [Microsoft Foundry models](https://ai.azure.com/explore/models)

107* [AI Foundry pricing](https://azure.microsoft.com/en-us/pricing/details/ai-foundry/)107* [Microsoft Foundry pricing](https://azure.microsoft.com/en-us/pricing/details/ai-foundry/)

Details

120**Available events**:120**Available events**:

121 121 

122* `PreToolUse`: Before Claude uses any tool122* `PreToolUse`: Before Claude uses any tool

123* `PermissionRequest`: When a permission dialog is shown

123* `PostToolUse`: After Claude uses any tool124* `PostToolUse`: After Claude uses any tool

124* `UserPromptSubmit`: When user submits a prompt125* `UserPromptSubmit`: When user submits a prompt

125* `Notification`: When Claude Code sends notifications126* `Notification`: When Claude Code sends notifications

settings.md +3 −3

Details

322| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | See [Model configuration](/en/model-config#environment-variables) |322| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | See [Model configuration](/en/model-config#environment-variables) |

323| `ANTHROPIC_DEFAULT_OPUS_MODEL` | See [Model configuration](/en/model-config#environment-variables) |323| `ANTHROPIC_DEFAULT_OPUS_MODEL` | See [Model configuration](/en/model-config#environment-variables) |

324| `ANTHROPIC_DEFAULT_SONNET_MODEL` | See [Model configuration](/en/model-config#environment-variables) |324| `ANTHROPIC_DEFAULT_SONNET_MODEL` | See [Model configuration](/en/model-config#environment-variables) |

325| `ANTHROPIC_FOUNDRY_API_KEY` | API key for Azure AI Foundry authentication (see [Azure AI Foundry](/en/azure-ai-foundry)) |325| `ANTHROPIC_FOUNDRY_API_KEY` | API key for Microsoft Foundry authentication (see [Microsoft Foundry](/en/microsoft-foundry)) |

326| `ANTHROPIC_MODEL` | Name of the model setting to use (see [Model Configuration](/en/model-config#environment-variables)) |326| `ANTHROPIC_MODEL` | Name of the model setting to use (see [Model Configuration](/en/model-config#environment-variables)) |

327| `ANTHROPIC_SMALL_FAST_MODEL` | \[DEPRECATED] Name of [Haiku-class model for background tasks](/en/costs) |327| `ANTHROPIC_SMALL_FAST_MODEL` | \[DEPRECATED] Name of [Haiku-class model for background tasks](/en/costs) |

328| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | Override AWS region for the Haiku-class model when using Bedrock |328| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | Override AWS region for the Haiku-class model when using Bedrock |


341| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | Skip auto-installation of IDE extensions |341| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | Skip auto-installation of IDE extensions |

342| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | Set the maximum number of output tokens for most requests |342| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | Set the maximum number of output tokens for most requests |

343| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | Skip AWS authentication for Bedrock (e.g. when using an LLM gateway) |343| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | Skip AWS authentication for Bedrock (e.g. when using an LLM gateway) |

344| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Skip Azure authentication for AI Foundry (e.g. when using an LLM gateway) |344| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Skip Azure authentication for Microsoft Foundry (e.g. when using an LLM gateway) |

345| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Skip Google authentication for Vertex (e.g. when using an LLM gateway) |345| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Skip Google authentication for Vertex (e.g. when using an LLM gateway) |

346| `CLAUDE_CODE_SUBAGENT_MODEL` | See [Model configuration](/en/model-config) |346| `CLAUDE_CODE_SUBAGENT_MODEL` | See [Model configuration](/en/model-config) |

347| `CLAUDE_CODE_USE_BEDROCK` | Use [Bedrock](/en/amazon-bedrock) |347| `CLAUDE_CODE_USE_BEDROCK` | Use [Bedrock](/en/amazon-bedrock) |

348| `CLAUDE_CODE_USE_FOUNDRY` | Use [Azure AI Foundry](/en/azure-ai-foundry) |348| `CLAUDE_CODE_USE_FOUNDRY` | Use [Microsoft Foundry](/en/microsoft-foundry) |

349| `CLAUDE_CODE_USE_VERTEX` | Use [Vertex](/en/google-vertex-ai) |349| `CLAUDE_CODE_USE_VERTEX` | Use [Vertex](/en/google-vertex-ai) |

350| `DISABLE_AUTOUPDATER` | Set to `1` to disable automatic updates. |350| `DISABLE_AUTOUPDATER` | Set to `1` to disable automatic updates. |

351| `DISABLE_BUG_COMMAND` | Set to `1` to disable the `/bug` command |351| `DISABLE_BUG_COMMAND` | Set to `1` to disable the `/bug` command |

setup.md +1 −1

Details

70 70 

711. **Claude Console**: The default option. Connect through the Claude Console and complete the OAuth process. Requires active billing at [console.anthropic.com](https://console.anthropic.com). A "Claude Code" workspace will be automatically created for usage tracking and cost management. Note that you cannot create API keys for the Claude Code workspace - it is dedicated exclusively for Claude Code usage.711. **Claude Console**: The default option. Connect through the Claude Console and complete the OAuth process. Requires active billing at [console.anthropic.com](https://console.anthropic.com). A "Claude Code" workspace will be automatically created for usage tracking and cost management. Note that you cannot create API keys for the Claude Code workspace - it is dedicated exclusively for Claude Code usage.

722. **Claude App (with Pro or Max plan)**: Subscribe to Claude's [Pro or Max plan](https://claude.com/pricing) for a unified subscription that includes both Claude Code and the web interface. Get more value at the same price point while managing your account in one place. Log in with your Claude.ai account. During launch, choose the option that matches your subscription type.722. **Claude App (with Pro or Max plan)**: Subscribe to Claude's [Pro or Max plan](https://claude.com/pricing) for a unified subscription that includes both Claude Code and the web interface. Get more value at the same price point while managing your account in one place. Log in with your Claude.ai account. During launch, choose the option that matches your subscription type.

733. **Enterprise platforms**: Configure Claude Code to use [Amazon Bedrock, Google Vertex AI, or Azure AI Foundry](/en/third-party-integrations) for enterprise deployments with your existing cloud infrastructure.733. **Enterprise platforms**: Configure Claude Code to use [Amazon Bedrock, Google Vertex AI, or Microsoft Foundry](/en/third-party-integrations) for enterprise deployments with your existing cloud infrastructure.

74 74 

75<Note>75<Note>

76 Claude Code securely stores your credentials. See [Credential Management](/en/iam#credential-management) for details.76 Claude Code securely stores your credentials. See [Credential Management](/en/iam#credential-management) for details.

Details

12 <th>Feature</th>12 <th>Feature</th>

13 <th>Anthropic</th>13 <th>Anthropic</th>

14 <th>Amazon Bedrock</th>14 <th>Amazon Bedrock</th>

15 <th>Azure AI Foundry</th>

16 <th>Google Vertex AI</th>15 <th>Google Vertex AI</th>

16 <th>Microsoft Foundry</th>

17 </tr>17 </tr>

18 </thead>18 </thead>

19 19 


22 <td>Regions</td>22 <td>Regions</td>

23 <td>Supported [countries](https://www.anthropic.com/supported-countries)</td>23 <td>Supported [countries](https://www.anthropic.com/supported-countries)</td>

24 <td>Multiple AWS [regions](https://docs.aws.amazon.com/bedrock/latest/userguide/models-regions.html)</td>24 <td>Multiple AWS [regions](https://docs.aws.amazon.com/bedrock/latest/userguide/models-regions.html)</td>

25 <td>Multiple Azure [regions](https://azure.microsoft.com/en-us/explore/global-infrastructure/products-by-region/)</td>

26 <td>Multiple GCP [regions](https://cloud.google.com/vertex-ai/generative-ai/docs/learn/locations)</td>25 <td>Multiple GCP [regions](https://cloud.google.com/vertex-ai/generative-ai/docs/learn/locations)</td>

26 <td>Multiple Azure [regions](https://azure.microsoft.com/en-us/explore/global-infrastructure/products-by-region/)</td>

27 </tr>27 </tr>

28 28 

29 <tr>29 <tr>


38 <td>Authentication</td>38 <td>Authentication</td>

39 <td>API key</td>39 <td>API key</td>

40 <td>API key or AWS credentials</td>40 <td>API key or AWS credentials</td>

41 <td>API key or Microsoft Entra ID</td>

42 <td>GCP credentials</td>41 <td>GCP credentials</td>

42 <td>API key or Microsoft Entra ID</td>

43 </tr>43 </tr>

44 44 

45 <tr>45 <tr>

46 <td>Cost tracking</td>46 <td>Cost tracking</td>

47 <td>Dashboard</td>47 <td>Dashboard</td>

48 <td>AWS Cost Explorer</td>48 <td>AWS Cost Explorer</td>

49 <td>Azure Cost Management</td>

50 <td>GCP Billing</td>49 <td>GCP Billing</td>

50 <td>Azure Cost Management</td>

51 </tr>51 </tr>

52 52 

53 <tr>53 <tr>

54 <td>Enterprise features</td>54 <td>Enterprise features</td>

55 <td>Teams, usage monitoring</td>55 <td>Teams, usage monitoring</td>

56 <td>IAM policies, CloudTrail</td>56 <td>IAM policies, CloudTrail</td>

57 <td>RBAC policies, Azure Monitor</td>

58 <td>IAM roles, Cloud Audit Logs</td>57 <td>IAM roles, Cloud Audit Logs</td>

58 <td>RBAC policies, Azure Monitor</td>

59 </tr>59 </tr>

60 </tbody>60 </tbody>

61</table>61</table>


67 Use Claude models through AWS infrastructure with API key or IAM-based authentication and AWS-native monitoring67 Use Claude models through AWS infrastructure with API key or IAM-based authentication and AWS-native monitoring

68 </Card>68 </Card>

69 69 

70 <Card title="Azure AI Foundry" icon="microsoft" href="/en/azure-ai-foundry">

71 Access Claude through Azure with API key or Microsoft Entra ID authentication and Azure billing

72 </Card>

73 

74 <Card title="Google Vertex AI" icon="google" href="/en/google-vertex-ai">70 <Card title="Google Vertex AI" icon="google" href="/en/google-vertex-ai">

75 Access Claude models via Google Cloud Platform with enterprise-grade security and compliance71 Access Claude models via Google Cloud Platform with enterprise-grade security and compliance

76 </Card>72 </Card>

73 

74 <Card title="Microsoft Foundry" icon="microsoft" href="/en/microsoft-foundry">

75 Access Claude through Azure with API key or Microsoft Entra ID authentication and Azure billing

76 </Card>

77</CardGroup>77</CardGroup>

78 78 

79## Corporate infrastructure79## Corporate infrastructure


127export CLAUDE_CODE_SKIP_BEDROCK_AUTH=1 # If gateway handles AWS auth127export CLAUDE_CODE_SKIP_BEDROCK_AUTH=1 # If gateway handles AWS auth

128```128```

129 129 

130### Using Azure AI Foundry with corporate proxy130### Using Foundry with corporate proxy

131 131 

132Route Azure traffic through a corporate HTTP/HTTPS proxy:132Route Azure traffic through a corporate HTTP/HTTPS proxy:

133 133 

134```bash theme={null}134```bash theme={null}

135# Enable Azure AI Foundry135# Enable Microsoft Foundry

136export CLAUDE_CODE_USE_FOUNDRY=1136export CLAUDE_CODE_USE_FOUNDRY=1

137export ANTHROPIC_FOUNDRY_RESOURCE=your-resource137export ANTHROPIC_FOUNDRY_RESOURCE=your-resource

138export ANTHROPIC_FOUNDRY_API_KEY=your-api-key # Or omit for Entra ID auth138export ANTHROPIC_FOUNDRY_API_KEY=your-api-key # Or omit for Entra ID auth


141export HTTPS_PROXY='https://proxy.example.com:8080'141export HTTPS_PROXY='https://proxy.example.com:8080'

142```142```

143 143 

144### Using Azure AI Foundry with LLM Gateway144### Using Foundry with LLM Gateway

145 145 

146Use a gateway service that provides Azure-compatible endpoints:146Use a gateway service that provides Azure-compatible endpoints:

147 147 

148```bash theme={null}148```bash theme={null}

149# Enable Azure AI Foundry149# Enable Microsoft Foundry

150export CLAUDE_CODE_USE_FOUNDRY=1150export CLAUDE_CODE_USE_FOUNDRY=1

151 151 

152# Configure LLM gateway152# Configure LLM gateway


253## Next steps253## Next steps

254 254 

255* [Set up Amazon Bedrock](/en/amazon-bedrock) for AWS-native deployment255* [Set up Amazon Bedrock](/en/amazon-bedrock) for AWS-native deployment

256* [Set up Azure AI Foundry](/en/azure-ai-foundry) for Azure deployment

257* [Configure Google Vertex AI](/en/google-vertex-ai) for GCP deployment256* [Configure Google Vertex AI](/en/google-vertex-ai) for GCP deployment

257* [Set up Microsoft Foundry](/en/microsoft-foundry) for Azure deployment

258* [Configure Enterprise Network](/en/network-config) for network requirements258* [Configure Enterprise Network](/en/network-config) for network requirements

259* [Deploy LLM Gateway](/en/llm-gateway) for enterprise management259* [Deploy LLM Gateway](/en/llm-gateway) for enterprise management

260* [Settings](/en/settings) for configuration options and environment variables260* [Settings](/en/settings) for configuration options and environment variables

vs-code.md +6 −6

Details

43 43 

44### Using Third-Party Providers44### Using Third-Party Providers

45 45 

46The VS Code extension supports using Claude Code with third-party providers like Amazon Bedrock, Azure AI Foundry, and Google Vertex AI. When configured with these providers, the extension will not prompt for login. To use third-party providers, configure environment variables in the VS Code extension settings:46The VS Code extension supports using Claude Code with third-party providers like Amazon Bedrock, Microsoft Foundry, and Google Vertex AI. When configured with these providers, the extension will not prompt for login. To use third-party providers, configure environment variables in the VS Code extension settings:

47 47 

481. Open VS Code settings481. Open VS Code settings

492. Search for "Claude Code: Environment Variables"492. Search for "Claude Code: Environment Variables"


52#### Environment Variables52#### Environment Variables

53 53 

54| Variable | Description | Required | Example |54| Variable | Description | Required | Example |

55| :---------------------------- | :------------------------------------- | :---------------------- | :----------------------------------------------- |55| :---------------------------- | :------------------------------------- | :----------------------------- | :----------------------------------------------- |

56| `CLAUDE_CODE_USE_BEDROCK` | Enable Amazon Bedrock integration | Required for Bedrock | `"1"` or `"true"` |56| `CLAUDE_CODE_USE_BEDROCK` | Enable Amazon Bedrock integration | Required for Bedrock | `"1"` or `"true"` |

57| `CLAUDE_CODE_USE_FOUNDRY` | Enable Azure AI Foundry integration | Required for Foundry | `"1"` or `"true"` |57| `CLAUDE_CODE_USE_FOUNDRY` | Enable Microsoft Foundry integration | Required for Foundry | `"1"` or `"true"` |

58| `CLAUDE_CODE_USE_VERTEX` | Enable Google Vertex AI integration | Required for Vertex AI | `"1"` or `"true"` |58| `CLAUDE_CODE_USE_VERTEX` | Enable Google Vertex AI integration | Required for Vertex AI | `"1"` or `"true"` |

59| `AWS_REGION` | AWS region for Bedrock | | `"us-east-2"` |59| `AWS_REGION` | AWS region for Bedrock | | `"us-east-2"` |

60| `AWS_PROFILE` | AWS profile for Bedrock authentication | | `"your-profile"` |60| `AWS_PROFILE` | AWS profile for Bedrock authentication | | `"your-profile"` |

61| `CLOUD_ML_REGION` | Region for Vertex AI | | `"global"` or `"us-east5"` |61| `CLOUD_ML_REGION` | Region for Vertex AI | | `"global"` or `"us-east5"` |

62| `ANTHROPIC_VERTEX_PROJECT_ID` | GCP project ID for Vertex AI | | `"your-project-id"` |62| `ANTHROPIC_VERTEX_PROJECT_ID` | GCP project ID for Vertex AI | | `"your-project-id"` |

63| `ANTHROPIC_FOUNDRY_RESOURCE` | Azure resource name for Foundry | Required for AI Foundry | `"your-resource"` |63| `ANTHROPIC_FOUNDRY_RESOURCE` | Azure resource name for Foundry | Required for Microsoft Foundry | `"your-resource"` |

64| `ANTHROPIC_FOUNDRY_API_KEY` | API key for Azure AI Foundry | Optional for AI Foundry | `"your-api-key"` |64| `ANTHROPIC_FOUNDRY_API_KEY` | API key for Microsoft Foundry | Optional for Microsoft Foundry | `"your-api-key"` |

65| `ANTHROPIC_MODEL` | Override primary model | Override model ID | `"us.anthropic.claude-sonnet-4-5-20250929-v1:0"` |65| `ANTHROPIC_MODEL` | Override primary model | Override model ID | `"us.anthropic.claude-sonnet-4-5-20250929-v1:0"` |

66| `ANTHROPIC_SMALL_FAST_MODEL` | Override small/fast model | Optional | `"us.anthropic.claude-3-5-haiku-20241022-v1:0"` |66| `ANTHROPIC_SMALL_FAST_MODEL` | Override small/fast model | Optional | `"us.anthropic.claude-3-5-haiku-20241022-v1:0"` |

67| `CLAUDE_CODE_SKIP_AUTH_LOGIN` | Disable all prompts to login | Optional | `"1"` or `"true"` |67| `CLAUDE_CODE_SKIP_AUTH_LOGIN` | Disable all prompts to login | Optional | `"1"` or `"true"` |


69For detailed setup instructions and additional configuration options, see:69For detailed setup instructions and additional configuration options, see:

70 70 

71* [Claude Code on Amazon Bedrock](/en/amazon-bedrock)71* [Claude Code on Amazon Bedrock](/en/amazon-bedrock)

72* [Claude Code on Azure AI Foundry](/en/azure-ai-foundry)72* [Claude Code on Microsoft Foundry](/en/microsoft-foundry)

73* [Claude Code on Google Vertex AI](/en/google-vertex-ai)73* [Claude Code on Google Vertex AI](/en/google-vertex-ai)

74 74 

75### Not Yet Implemented75### Not Yet Implemented