Skip to content

Security

Michael Carey edited this page Mar 18, 2026 · 1 revision

Security

This page covers secure usage practices for seq-mcp.

Core Principles

  • Use least-privilege Seq API keys.
  • Keep credentials out of source control.
  • Prefer HTTPS for non-local Seq endpoints.
  • Grant permissions only for the tools/routes your client actually calls.

Required Secret Handling

Required variables:

  • SEQ_URL
  • SEQ_API_KEY

Do not hardcode keys in source files.

Prefer:

  • Environment variables.
  • Secret stores.
  • Local .env files that are excluded from commits.

API Key Permission Guidance

References:

Typical permission usage:

  • Read: required for starter query and retrieval workflows.
  • Ingest: only if using ingestion routes.
  • Write: only for mutation routes.
  • Project, Organization, System: only for admin routes that explicitly need them.

Operational Security Checklist

  • Rotate API keys regularly.
  • Remove unused keys.
  • Review tool usage and permission scope periodically.
  • Use dedicated keys per environment when possible.

Transport Security

  • Local development may use http://localhost.
  • For any remote endpoint, use https:// and valid TLS configuration.

Common Mistakes to Avoid

  • Reusing an over-privileged admin key for all clients.
  • Passing secrets in logs, screenshots, or issue comments.
  • Assuming starter-tool permissions are enough for broad API tools.

See also: Tools Reference and Troubleshooting.