Connect the MCP server

Blenau exposes a remote Model Context Protocol (MCP) server. Once connected, your agent can search, read and write your knowledge base — backed by your GitHub repos — without you writing any glue code.

Endpoint

https://api.blenau.com/mcp/sse?token=blenau_tk_xxxxxxxx

It’s an SSE MCP endpoint. The server is remote and multi-tenant; your token scopes every call to your workspace.

1. Get a token

From the Blenau dashboard → Settings, create an MCP token. It looks like blenau_tk_…. Treat it like a password.

2. Add it to your client

Claude Code

claude mcp add --transport sse blenau "https://api.blenau.com/mcp/sse?token=blenau_tk_xxxxxxxx"

Claude Desktop / other MCP clients

Add an SSE server entry pointing at the endpoint above. After connecting, reconnect / refresh the tool list so the client picks up the latest tools.

What your agent can do

Tool	Purpose
search_knowledge	Semantic search across the workspace. Start here.
list_repos	List connected repos and their path_prefix (routing).
get_document / get_document_structure / get_section	Read docs and section versions.
ingest_document	Create a new doc (commits to GitHub).
edit_section / patch_section	Edit/append a section (optimistic locking via content_hash).
create_asset_upload	Attach an image/file to a doc — see Images & assets.
crystallize_session / smart_crystallize	Turn raw session notes into structured docs.
audit_links / suggest_crosslinks	Keep the cross-link graph healthy.

How a good agent behaves

1. Search first, write later. Run search_knowledge before creating anything.
2. If a result is a strong match, edit the existing section instead of creating a duplicate. Fetch get_section right before writing to pass the current expected_version.
3. Route by prefix. Call list_repos to learn each repo’s path_prefix and prepend it to the document path.
4. Cite sources. Pass a sources list whenever you record something learned from external material — unsourced claims show up in audit_links.

Troubleshooting

• Tools missing after a deploy / idle period → reconnect the MCP session; the tool list refreshes on reconnect.
• session_expired / session_invalid → the SSE stream was dropped (edge idle timeout, server restart). Re-open the SSE connection.