# integrations

## Overview

- [Integrations Overview](/docs/integrations/integrations-overview) — Connect Black Ice to your AI localization pipeline via GitHub Sync, MCP, REST API, or Workspace API. Compare paths and pick the right one for your team.

## GitHub Sync

- [GitHub Sync](/docs/integrations/github-sync) — Push your ontology to GitHub as a structured markdown bundle for AI agents and programmatic consumption.

## AI Integrations

- [Black Ice + AI: What Your Ontology Unlocks](/docs/integrations/ai-integrations-overview) — How to feed your Black Ice ontology to Claude, ChatGPT, Gemini, and local models via MCP, the REST API, or GitHub Sync — with a comparison of access paths.
- [Connect Claude to your workspace (step by step)](/docs/integrations/connect-claude-mcp) — Step-by-step guide with screenshots: add Black Ice as a custom connector in Claude, authorize the workspace over OAuth, and start asking Claude about your terminology.
- [Connect Cursor and other MCP clients](/docs/integrations/connect-cursor-mcp) — Connect Cursor, VS Code, and other MCP clients to your Black Ice workspace over the remote MCP server.
- [Connecting MCP clients to Black Ice](/docs/integrations/claude-desktop-mcp) — Connect Claude Desktop, Claude Code, Cursor, and other MCP clients to your Black Ice workspace to check approved terms and market availability live.
- [API Reference](/docs/integrations/api-reference) — Read and write your workspace ontology programmatically — endpoints, auth, schemas, and a downloadable full reference.
- [API & MCP rate limits](/docs/integrations/rate-limits) — Per-plan throughput caps for the MCP server and Workspace API, response headers, and how to design pipelines around them.
- [Switching the workspace Claude or Cursor uses](/docs/integrations/switch-mcp-workspace) — Force an MCP client to re-authorize against a different workspace.

## Workspace API

- [Workspace API access](/docs/integrations/workspace-api-access) — Read and write your ontology programmatically from external tools.
- [Pulling the ontology into your stack (integration guide)](/docs/integrations/ontology-pull-integration) — Step-by-step guide for pulling your Black Ice ontology into an external system over the read API: read-only keys, pagination, incremental sync, rate limits, and errors.
- [Managing and troubleshooting API keys](/docs/integrations/api-key-management) — Create, rotate, revoke, and debug Workspace API keys, including the meaning of 401, 403, and 429 responses.
- [Privacy by design in Black Ice integrations](/docs/integrations/privacy-by-design-integrations) — How to connect Black Ice while minimizing data movement, using read-only access, and keeping customer ontology data out of model training.