MCP integration
Let your tool look things up. Atlavium remains the source.
MCP lets compatible external programs look things up in your Atlavium. A program can use this connection to search your notes, for example. The MCP server is available to every user.
Read and search your content
Once you sign in, your program can read and search all the content your Atlavium account can access. You do not need to select or share individual notes first. The program cannot create or change entries. If it gives you a draft, you copy it into Atlavium yourself.
Connect your program
Enter the server address below in your MCP program. Then sign in with your Atlavium account and allow the program to access your content. No extra activation is needed.
Use a compatible program
Your program needs to support connections to an MCP server with sign-in. If you get stuck setting it up, drop by Discord. I’m happy to help.
Set up Codex
Use the Codex CLI to set up the connection in a terminal. Run these commands one at a time, then sign in to Atlavium in your browser.
codex mcp add atlavium --url https://app.atlavium.com/mcp
codex mcp login atlaviumYou can also add the section below to your ~/.codex/config.toml file. Then sign in with codex mcp login atlavium.
[mcp_servers.atlavium]
url = "https://app.atlavium.com/mcp"Use /mcp in Codex to see whether the server is connected.
Set up GitHub Copilot in VS Code
Create .vscode/mcp.json in your project with the following content. If the file already contains other servers, add Atlavium under servers.
{
"servers": {
"atlavium": {
"type": "http",
"url": "https://app.atlavium.com/mcp"
}
}
}Save the file and click Start above the configuration. Follow the Atlavium sign-in steps in your browser. Then open Copilot Chat and select Agent mode. Use the tools picker to enable the Atlavium tools.
Want to use Atlavium in all your projects? Open the VS Code Command Palette and choose MCP: Open User Configuration. You can add the same server there.
Claude, Cursor and other apps
Claude calls these connections custom connectors. Cursor also supports remote MCP servers. Their guides explain the setup and requirements.
If you use GitHub Copilot in your terminal, follow the Copilot CLI guide. Its configuration format differs from the one VS Code uses.
Microsoft Copilot Studio and Microsoft 365
Copilot Studio lets you build your own agents and add an MCP server as a tool. Along with the server address, you need to set up OAuth sign-in. Microsoft’s guide explains the available options.
Microsoft 365 Copilot uses extensions for custom agents to connect to MCP. This is a different setup from GitHub Copilot in VS Code.
Check the external service’s privacy policy
An external service may process the content it retrieves outside Atlavium. Read its terms and privacy policy before setting up the connection.
Not required for getting started
You do not need MCP to create a Realm or start using the app. Begin with the relevant tools in Atlavium and add an external connection only when it helps your workflow.
A home for your Realm
There’s already room for your first story.
Create your first Realm, add two characters and record what connects them. Your Atlavium can grow with your stories. Compendium features will remain free within your granted allowances.