Getting started · Tutorial · 2 min

Use Known in Claude Code

Connect Known to Claude Code so it can read your company's wikis in every project and record the decisions you make. This takes about 2 minutes.

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