Connecting your tools
Zep is useful once it’s connected to the services you actually work in. The first-run onboarding flow walks you through this, but you can always redo these steps from Settings in the UI.
Slack
Zep talks to Slack via the Anthropic MCP proxy. No bot tokens, no custom app.
- Open Settings → Integrations → Slack.
- Click Connect Slack. A browser tab opens to Slack’s OAuth page.
- Approve. You’ll be redirected back to Zep.
Zep can now pull thread context when analyzing DAG failures or merge requests.
GitLab
- Open Settings → Integrations → GitLab.
- Enter your GitLab host (e.g.
gitlab.comor your self-hosted URL). - Click Connect. You’ll be taken through OAuth.
Airflow
Airflow is read-only and uses a service account.
- Open Settings → Integrations → Airflow.
- Enter the base URL (e.g.
https://airflow.example.com). - Paste a username + app password for a read-only account.
Zep validates the connection on save. If it fails, check the URL and credentials; see Troubleshooting.
Claude CLI
Zep uses your installed Claude CLI for analysis. If you’ve already run claude auth, you’re done. Otherwise:
claude authZep picks up the credentials from your home directory automatically.