{% extends "base.html" %} {% block title %}AgenticStore Setup{% endblock %} {% block content %}
Configure credentials once — all linked tools will use them automatically.
Select which tools to expose in your MCP client. Deselecting keeps them installed but unlisted.
Choose your AI client. We'll write the MCP config automatically.
Manage persistent memory so AI agents can hand off work across sessions and clients.
Free-form markdown. Agents read this to understand your project goals, constraints, and preferred patterns.
Common issues and fixes.
The GitHub API rejected your token. This usually means the token is expired, has the wrong scopes, or was pasted incorrectly.
Fine-grained PATs require explicit per-repo permission grants and often hit unexpected 401s for org repos.
A Classic PAT with repo scope is the most reliable option.
agentic-store-mcpGo to → GitHub → paste the token → Save → Test Connection. You should see ✓ Authenticated as your-username.
PATs have the same access as your GitHub account. If you suspect a token was exposed, revoke it immediately at github.com/settings/tokens.
When running in Docker, the webapp and the MCP server run in separate containers. Both must mount the same volume for secrets to be shared.
docker compose up -d
Go to and save your tokens.
Your client config must include the -v flag. See the
tab for the exact snippet.
Dependencies aren't installed yet.
uv sync
All dependencies (PyGithub, FastAPI, keyring, etc.) are installed by default — no extras needed.
The MCP server process exited immediately after starting. The log shows
ModuleNotFoundError: No module named 'mcp' even though the package
is listed in pyproject.toml. This usually means the virtual environment
is missing or stale.
cd /path/to/agentic-store-mcp uv sync
This installs mcp, PyGithub, keyring, and all other dependencies into the local .venv.
If another project's venv is active in your shell, uv run may
warn "VIRTUAL_ENV does not match the project environment path".
Deactivate it first, then retry:
deactivate uv sync
After syncing, restart Claude Desktop / Claude Code / Cursor so the MCP server process is relaunched with the updated environment.