Difficulty / est. effort: ~1h, small (docs + config)
Context: Zed is a fast modern editor whose assistant supports MCP via "context servers". A recipe lets Zed users consult an OKF bundle via okf-mcp. src/OKF4net.Mcp/README.md documents only Claude today.
Files to touch: src/OKF4net.Mcp/README.md (add a ### Use with Zed section).
What to do:
- Add a
### Use with Zed section.
- Show the Zed
settings.json context_servers entry pointing at okf-mcp with the bundle-path args (Zed uses its own shape, e.g. "context_servers": {"okf": {"command": {"path": "okf-mcp", "args": ["<bundle>"]}}}). Verify against current Zed docs and link them: https://zed.dev/docs/ai/mcp
- Mention
OKF_MCP_READONLY=1.
How to verify:
dotnet tool install -g OKF4net.Mcp (installs okf-mcp).
- Point the config at a small test bundle (e.g.
tests/fixtures/ has example bundles, or make a throwaway one with a single type:-tagged concept).
- Restart the editor, open its MCP/agent panel, and confirm the
okf server connects and the OKF tools appear (okf_read_concept, okf_browse, okf_graph, okf_search, okf_validate_bundle, okf_changes_since).
- Ask the assistant to read or browse a concept from the bundle and confirm it works. Add a
OKF_MCP_READONLY=1 note for read-only use.
Docs-only change — no build impact — but run dotnet build OKF4net.sln to be safe.
Good to know: Model the new section on the existing "Use with Claude Desktop" block in src/OKF4net.Mcp/README.md (same command: "okf-mcp" + bundle-path args, or OKF_BUNDLE_ROOT env). MCP is a standard stdio protocol, so the server itself needs no change — only the client-side config differs. See CONTRIBUTING.md. If you get stuck on a config format, open a Discussion.
Difficulty / est. effort: ~1h, small (docs + config)
Context: Zed is a fast modern editor whose assistant supports MCP via "context servers". A recipe lets Zed users consult an OKF bundle via
okf-mcp.src/OKF4net.Mcp/README.mddocuments only Claude today.Files to touch:
src/OKF4net.Mcp/README.md(add a### Use with Zedsection).What to do:
### Use with Zedsection.settings.jsoncontext_serversentry pointing atokf-mcpwith the bundle-path args (Zed uses its own shape, e.g."context_servers": {"okf": {"command": {"path": "okf-mcp", "args": ["<bundle>"]}}}). Verify against current Zed docs and link them: https://zed.dev/docs/ai/mcpOKF_MCP_READONLY=1.How to verify:
dotnet tool install -g OKF4net.Mcp(installsokf-mcp).tests/fixtures/has example bundles, or make a throwaway one with a singletype:-tagged concept).okfserver connects and the OKF tools appear (okf_read_concept,okf_browse,okf_graph,okf_search,okf_validate_bundle,okf_changes_since).OKF_MCP_READONLY=1note for read-only use.Docs-only change — no build impact — but run
dotnet build OKF4net.slnto be safe.Good to know: Model the new section on the existing "Use with Claude Desktop" block in
src/OKF4net.Mcp/README.md(samecommand: "okf-mcp"+ bundle-pathargs, orOKF_BUNDLE_ROOTenv). MCP is a standard stdio protocol, so the server itself needs no change — only the client-side config differs. See CONTRIBUTING.md. If you get stuck on a config format, open a Discussion.