> ## 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.

# Connect your AI tool

> Pick the right connection and prove it can use your knowledge.

**Outcome:** your tool opens a known page and identifies its source.

**Before you start:** have a saved page you may read, a working AI client, and
permission and allowance to create its connection. Northern Logic does not
include the client’s model subscription.

| Where your tool works                                              | Choose                     | Start                                                |
| ------------------------------------------------------------------ | -------------------------- | ---------------------------------------------------- |
| On a machine where it can read and edit files                      | Local sync                 | [Pair a machine](/connections/local-sync)            |
| In a remote chat or environment without access to your local files | Remote MCP                 | [Connect a remote client](/connections/remote-mcp)   |
| On a machine already paired for another tool                       | Existing replica           | Use **Add this harness**; keep the existing replica. |
| Only in the Knowledge web app                                      | No agent connection needed | [Create a page](/quickstart)                         |

```mermaid theme={null}
flowchart TD
  K[Saved cloud knowledge] <-->|Permitted synchronization| L[Local Markdown replica]
  L <--> F[File-capable AI tool]
  R[Remote AI client] <-->|Authorized MCP requests| K
```

The diagram shows two ways to reach knowledge. Both are limited by the user’s
vault access and the connection’s grants. Downloaded local files remain on a
machine after remote access is revoked.

## Follow the setup for your tool

[Claude Code](/connections/claude-code) and [Hermes Agent](/connections/hermes)
have dedicated guides. See [Client compatibility](/connections/compatibility)
for the distinction between documented setup and an end-to-end verified
connection.

## Prove it works

Ask the tool to orient to your workspace, find a known page, open it, and quote
one short fact with its source path. Inspect the tool’s source and compare it
with the saved page. A fluent answer without a source is not a connection check.

Continue with [Get your first useful AI answer](/tutorials/first-ai-answer),
which includes fictional sample content and a before/after test.

**If it did not work:**
[My agent cannot find a page](/help/agent-cannot-find-page).