Connect Your AI
Give your AI persistent memory in minutes.
What is MCP?
Model Context Protocol (MCP) is an open standard that allows AI assistants to connect to external tools. Think of it as a plugin system for AI.
When you connect Claude Code or Cursor to ekkOS via MCP, they gain the ability to:
- Remember context across sessions
- Learn from successful problem-solving
- Apply proven patterns automatically
- Follow your rules consistently
Claude Code Setup
Step 1: Locate your settings file
Claude Code stores its configuration in ~/.claude/settings.json
# macOS/Linux ~/.claude/settings.json # Windows %USERPROFILE%\.claude\settings.json
Step 2: Add ekkOS MCP server
Add this to your settings.json:
{
"mcpServers": {
"ekkos-memory": {
"command": "npx",
"args": ["-y", "@ekkos/mcp-server"],
"env": {
"EKKOS_API_KEY": "your_api_key_here"
}
}
}
}Step 3: Restart Claude Code
Close your terminal and reopen it. Claude Code will load the MCP server on next launch.
Ask Claude: "Search my memory for recent patterns"— if it uses the memory tools, you're connected.
Cursor Setup
Step 1: Create MCP configuration
Create .cursor/mcp.json in your project root:
{
"mcpServers": {
"ekkos-memory": {
"command": "npx",
"args": ["-y", "@ekkos/mcp-server"],
"env": {
"EKKOS_API_KEY": "your_api_key_here"
}
}
}
}Step 2: Enable MCP in Cursor Settings
- 1Open Cursor Settings (Cmd/Ctrl + ,)
- 2Search for "MCP"
- 3Enable "Use MCP Servers"
Step 3: Reload Window
Press Cmd/Ctrl + Shift + P and run "Reload Window"
What You Can Do
Search Memory
"Search my memory for authentication patterns"
Save Patterns
"Remember this solution for next time"
Set Rules
"Always use TypeScript strict mode"
Recall Conversations
"What did we discuss about the database?"
Troubleshooting
MCP server not starting?
1. Verify Node.js 18+ is installed: node --version
2. Check npx is available: npx --version
3. Try running manually: EKKOS_API_KEY=xxx npx @ekkos/mcp-server
AI not using memory tools?
1. Explicitly ask: "Search my memory for..." or "Use ekkOS to..."
2. Verify the MCP server is connected
3. Check your API key is valid at ekkos.dev