Amami MCP docs

Teams and sharing

Amami keeps the Umami-style collaboration model: teams can manage multiple websites, share dashboards, and give different people different levels of access. MCP adds a new question: what should an AI assistant be allowed to inspect or change?

Team structure

Use teams when:

  • Multiple people need access to the same websites.
  • Marketing, product, and engineering share analytics work.
  • Agencies manage several client sites.
  • You need separate access for internal and external collaborators.

Recommended structure:

  • One team per company or client.
  • One website per production domain.
  • Separate staging or preview sites only when you intentionally want to measure them.
  • Shared reports for recurring reviews.

Role model

Exact role names can vary by deployment, but the access model should stay simple:

  • Owner: manages team settings, members, websites, and billing.
  • Admin: manages websites, reports, events, goals, and team analytics workflows.
  • Viewer: reads dashboards, reports, and shared analytics.

When AI access is involved, prefer the least privilege that can complete the job.

Sharing dashboards and reports

Use sharing when someone needs visibility without full team access:

  • Public campaign report.
  • Client-facing website dashboard.
  • Weekly executive summary.
  • One-off debugging view for engineering.

Before sharing, check whether the report contains sensitive campaign names, private URLs, or internal event names.

Agent access guidelines

Use read-only MCP access for:

  • Daily summaries.
  • Traffic and source analysis.
  • Page and campaign comparison.
  • Report generation.

Enable write access only when the assistant must:

  • Create a tracked website.
  • Send a test event.
  • Configure setup resources.
  • Update an allowed analytics object.

Avoid destructive access unless you are operating a self-hosted instance and intentionally testing admin workflows.

Team prompts

List the websites I can access, group them by team if available, and tell me which one matches this project.
Create a weekly report for the marketing team. Include traffic changes, top pages, top sources, conversion events, and three actions.