> For the complete documentation index, see [llms.txt](https://docs.visdom.virtuslab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.visdom.virtuslab.com/visdom-context-fabric/user-guide/using-context-fabric-stand-alone.md).

# Using Context Fabric stand-alone

Context Fabric's MCP tools work from a local coding agent. The example below uses Claude Code; other MCP clients follow the same shape.

{% hint style="info" %}
Context Fabric exposes two sets of tools, **remote** and **workspace**. This page uses the remote set. The workspace set is designed to work with the Orchestrator, where some capabilities, the [wiki](/visdom-context-fabric/user-guide/wiki-module.md) for instance, arrive over a shared drive. In the remote variant everything is delivered over MCP.
{% endhint %}

There are three steps: add the MCP server, authenticate, and pull in the generated `AGENTS.md`.

## Connecting to the MCP server

```bash
claude mcp add --transport http visdom https://your-context-fabric-host/mcp/remote --client-id visdom-context-mcp
```

Then open Claude and run `/mcp`. Select the new server and choose Authenticate.

![The /mcp view in Claude Code, with the server waiting to be authenticated](https://1398155133-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FED9nLcXxDQR0x7nt8zMS%2Fuploads%2FgK1dOBNeaRw8awEpvQzM%2Fclaude-code-mcp-authenticate.png?alt=media)

You are given an authentication link; open it and sign in through your identity provider. Locally the redirect completes on its own. On a remote machine, copy the `localhost` address you were redirected to and paste it verbatim into the authentication box.

## Referencing AGENTS.md

The generated `AGENTS.md` evolves, so it should be fetched fresh for each session rather than copied once. An MCP tool returns its text; what remains is telling the agent to call it at the start of a session.

Edit `CLAUDE.local.md`, which should be git-ignored since this configuration is specific to your machine, and paste:

```markdown
# First action in every session

You MUST call the `agents_md` MCP tool with `project: "XYZ"`. If it is not
in your tool list, find it with ToolSearch first.

Call it before reading files, before searching the codebase, and before
answering, including when the request looks trivial or read-only. Once per
session, not once per turn.

If the call fails, say so in one line and carry on. Do not retry in a loop.

`XYZ` is the project slug. Pass it as the `project` argument of every
visdom MCP tool call in this repo.
```

Replace `XYZ` with your project's slug. The fetched `AGENTS.md` carries the repository list and instructions for using the wiki and memory where those modules are enabled.

Both the tools and the content of the upfront context can be previewed in the Context Fabric UI.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.visdom.virtuslab.com/visdom-context-fabric/user-guide/using-context-fabric-stand-alone.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
