# Use Known in Claude Code

## Before you start

- A Known account in the organization you want Claude Code to use.
- Claude Code installed.

## Add Known

1. In a terminal, run:

   ```
   claude mcp add --transport http --scope user known https://api.known.info/mcp
   ```

   `--scope user` makes Known available in every project. Leave it out to add Known to the current project only.

2. Start Claude Code, run `/mcp`, select **known**, then **Authenticate**.
3. Known opens in your browser. Sign in, choose the organizations Claude Code may use, confirm it's you, and select **Allow**.

## Check the connection

Ask Claude Code:

```
Which wikis can you see in Known?
```

It lists your organization's wikis. Ask it to read a page you know, and it answers with a link to that page in Known.

## Troubleshooting

- **`/mcp` shows Known as failed.** Run `claude mcp get known` to see the error, then authenticate again from `/mcp`.
- **Claude Code can't see a wiki you expected.** It can only use the organizations you selected. To change them, go to **Settings → Connections** in Known.

## Next steps

- [The known CLI](https://known.info/docs/cli), for scripts and agents that work from the terminal.
- [What Claude Code can do with Known, and its permissions](https://known.info/docs/connect-agent)