Integrations

Many hosts, not an island

Shield KYA works with the coding hosts you already use. Shipped recipes below. New hosts arrive by public pull request, then they show here and on the homepage strip.

15.7k npm installs 23 hosts shipped

npm i -g @shield-agent/kya@latest && kya start

kya start writes .mcp.json, mcp.json, and .cursor/mcp.json, then opens the live receipt.

One command - `kya connect`

The CLI writes the host config itself. It merges with your existing config and never overwrites it. Where the host supports it, --project limits the wiring to one repository.

Cursor (IDE + Agent CLI)

kya connect cursor → ~/.cursor/mcp.json. One config covers the IDE and the Agent CLI. Full recipe (verify step, uninstall, troubleshooting).

OpenCode

kya connect opencode → ~/.config/opencode/opencode.json. Local MCP entry under the mcp key; project scope supported. Full recipe (verify step, uninstall, troubleshooting).

Qwen Code

kya connect qwen → ~/.qwen/settings.json. Stdio or hosted variant; never enable both. Full recipe (verify step, uninstall, troubleshooting).

Kimi Code CLI

kya connect kimi → ~/.kimi-code/mcp.json. Standard mcpServers entry. Full recipe (verify step, uninstall, troubleshooting).

Kiro CLI

kya connect kiro → ~/.kiro/settings/mcp.json. Standard mcpServers entry; project scope supported. Full recipe (verify step, uninstall, troubleshooting).

Kilo Code CLI

kya connect kilo → ~/.config/kilo/kilo.json. Same local-server shape as OpenCode. Full recipe (verify step, uninstall, troubleshooting).

MastraCode

kya connect mastracode → ~/.mastracode/mcp.json. Standard mcpServers entry. Full recipe (verify step, uninstall, troubleshooting).

Amp

kya connect amp → ~/.config/amp/settings.json. Amp prefixes its root key: amp.mcpServers, not mcpServers. Full recipe (verify step, uninstall, troubleshooting).

GitHub Copilot CLI

kya connect copilot → ~/.copilot/mcp-config.json. Global config only - no project scope. Full recipe (verify step, uninstall, troubleshooting).

Config recipe

Copy a shipped example into the host config. The config path is known, but it is not safe to write automatically, so you copy the example by hand.

Claude Code / Desktop / claude.ai

.mcp.json or Desktop settings. kya start wires .mcp.json; Desktop and claude.ai use shipped examples. Full recipe (example file, verify step, troubleshooting).

Codex (OpenAI)

~/.codex/config.toml. TOML config with its own conventions - merge the example by hand. Full recipe (example file, verify step, troubleshooting).

Gemini CLI

~/.gemini/settings.json. Merge the stdio or hosted example; keep trust:false. Full recipe (example file, verify step, troubleshooting).

Grok

https://shield-agent.com/mcp. Hosted-only: grok.com rejects localhost. Never tunnel the OSS server. Full recipe (example file, verify step, troubleshooting).

Cline (VS Code)

VS Code globalStorage. Config lives in VS Code globalStorage - merge by hand. Weakest MCP coverage of the MCP hosts. Full recipe (example file, verify step, troubleshooting).

Droid (Factory)

~/.factory/mcp.json. Prefer droid mcp add; on-disk schema is unverified. Full recipe (example file, verify step, troubleshooting).

Any CLI - `kya wrap`

These hosts have no documented MCP support. kya wrap --offline checks the command before it runs and records the result on the trail. Only the wrapped command is covered. The agent's own tool calls inside a session are not gated.