{% extends "base.html" %} {% block title %}Firewall — AgenticStore{% endblock %} {% block content %}
🛡️

System-Level Proxy

Intercepts all Claude traffic at the OS level — no manual env vars needed.

CA — Network — Proxy —
1Generate local CA certificate
2Trust CA in login keychain (one password prompt)
3Set macOS network proxy → localhost
4Start TLS-intercepting proxy
Fully reversible.
Proxy stopped
0requests
0redacted
0blocked

Layer 1 — Deterministic Rules Always On

Fast regex + entropy detection. Runs on every request, zero latency.

Action Mode

Layer 2 — LLM Reviewer Optional

Local open-source model via Ollama catches context-aware leaks that regex misses.

Audit Log

Test Detection
Loading…

Prompt Recordings

Loading…

Connectors

Configure credentials once — all linked tools will use them automatically.

Loading connectors…

Tools

Select which tools to expose in your MCP client.

Loading tools…

Clients

Choose your AI client. We'll write the MCP config automatically.

Loading clients…

Agent Memory

Persistent memory so AI agents can hand off work across sessions.

Loading…

Checkpoints

Loading checkpoints…

Strategy

Free-form markdown. Agents read this to understand your project goals and constraints.

Stored Facts

Loading facts…

Session Log

Loading log…

Troubleshoot

Common issues and fixes.

GitHub

401 Bad Credentials

The GitHub API rejected your token — expired, wrong scopes, or pasted incorrectly.

1
Use a Classic PAT, not fine-grained

Fine-grained PATs hit unexpected 401s for org repos. A Classic PAT with repo scope is most reliable.

2
Generate a new token with the right scope
  1. Go to github.com/settings/tokens/new
  2. Note: agentic-store-mcp
  3. Scopes: check repo
  4. Click Generate token and copy immediately
3
Save it in Connectors

Go to → GitHub → paste token → Save → Test Connection.

Docker

Secrets configured in webapp not seen by MCP server

Webapp and MCP server run in separate containers — both must mount the same volume.

1
Start with docker compose
docker compose up -d
2
Configure secrets here

Go to and save your tokens.

3
Mount the same volume

Your client config must include the -v flag. See the tab for the snippet.

General

Tool returns "PyGithub not installed" or import error

Dependencies aren't installed yet.

1
Run uv sync
uv sync
General

Server disconnected — "No module named 'mcp'"

MCP server exited immediately. Virtual environment is missing or stale.

1
Re-sync the virtual environment
cd /path/to/agentic-store-mcp
uv sync
2
Deactivate conflicting venv
deactivate
uv sync
3
Restart your AI client

Restart Claude Desktop / Cursor so the MCP server relaunches with the updated environment.

{% endblock %}