> ## Documentation Index
> Fetch the complete documentation index at: https://docs.northernlogic.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Hermes Agent

> Use a local replica or add Northern Logic as an OAuth MCP server.

**Before you start:** Hermes must be installed with a working model connection.
Have access to a known Northern Logic page and the required connection
allowance. Hermes model/provider login is separate from Northern Logic
authorization.

## Local files

Follow [Pair a machine](/connections/local-sync) and give the app-generated
setup prompt to Hermes on that machine. For an already paired machine, use **Add
this harness**. Confirm `nlkb doctor` passes and use `nlkb orient` to find the
actual mounted vault. Give Hermes access to that location through its normal
file controls.

Ask Hermes to open a known page and report its path and one short supporting
sentence. Do this before asking it to edit shared knowledge.

## Remote MCP with OAuth

For direct cloud access without a local replica, add a named server:

```sh theme={null}
hermes mcp add --url https://mcp.northernlogic.ai/mcp --auth oauth northern-logic
```

Complete the browser authorization when prompted, using the intended Northern
Logic identity. Review the resulting connection's workspace and vault grants in
the app. Team vaults need explicit selection; the connection cannot exceed its
owner's access.

Test discovery from your terminal:

```sh theme={null}
hermes mcp test northern-logic
```

Start a new Hermes chat, or use `/reload-mcp` in an existing session to load the
server's tools. Registration or successful tool discovery alone does not prove
access to a particular vault.

## Check your result

Ask Hermes to orient, search for the known page, read it, and include the source
path in its answer. Compare the source with the app and inspect the connection's
recent activity. Then try
[the first-answer walkthrough](/tutorials/first-ai-answer).

## If it did not work

If tools are missing, reload MCP and inspect the test error. If authentication
is rejected, check the client version and browser flow; do not put a durable key
into a knowledge page or shared config as a workaround. If the server connects
but the page is missing, follow
[source and access checks](/help/agent-cannot-find-page).

Scheduled wiki maintenance belongs to Hermes when you configure it there.
Northern Logic does not start a Hermes job when you create a connection. Confirm
the job and its completed result in Hermes before relying on a schedule.

**Verification status:** `add --url --auth oauth` and `test` syntax were checked
against installed CLI help, and session reload behavior against the
[official Hermes guide](https://hermes-agent.nousresearch.com/docs/guides/manage-hermes-cloud-with-mcp),
on September 5, 2026. An authenticated end-to-end Northern Logic connection has
not been verified for this guide. See
[compatibility](/connections/compatibility).