Getting started · 2 min read
Connect an agent
Connect Claude, ChatGPT, or another MCP client to Known, and learn what connected agents can do.
Choose your tool
You can connect AI assistants and coding agents to Known with MCP (Model Context Protocol). Agents sign in through your browser, so you don't need an API key.
MCP server address
https://api.known.info/mcpConnect
Select your tool above for step-by-step instructions. For any tool, the steps are:
- Add Known as a remote MCP server, using the address above.
- Sign in to Known in your browser. Select the organizations the agent can use, confirm your identity, and click Allow. No organizations are selected by default.
- Ask the agent which wikis it can see, then ask it to read a page you know.
Other tools that support remote MCP servers with browser sign-in should work the same way. If one doesn't, let us know.
Available tools
Connected agents can use Known's wiki tools to:
| Read | Write |
|---|---|
| List wikis and show a wiki's pages | Create a wiki (admins only) |
| Search and read pages | Write, edit, move, and remove pages |
| Read page history and recent changes | Change a page's metadata |
| Read records and notes | Write and delete records |
| Look up who made a change | Add and resolve notes |
Results include the address of each page and record in Known, so agents can link to their sources.
Permissions
- An agent has your access, in the organizations you selected. If you leave an organization or lose access to a wiki, the agent does too.
- Changes made by an agent show the agent and your name, for example "ChatGPT for Ada".
- Agents can't delete page history.
For more, see Agents.
Use your voice
You can talk to a connected agent instead of typing. See Use Known by voice.
Change or disconnect an agent
In Known, go to Settings → Connections. In the Agents section, you can change the organizations an agent can use, disconnect an agent, or disconnect all your agents. Adding an organization asks you to confirm your identity. Disconnecting takes effect on the agent's next request.
Organization admins can see the agents connected to their organization and remove them.
Troubleshooting
ChatGPT uses an old list of tools
ChatGPT keeps the tool list a chat started with. After Known's tools change, refresh the app in ChatGPT's settings and start a new chat.
The agent can't find a wiki
The agent can only use the organizations you selected. To change them, go to Settings → Connections.
The agent shows a generic icon
Some clients use their own icon for custom connectors instead of the server's.