Skip to content

Security: contextflow/targetprocess-mcp-server

Security

SECURITY.md

Security Policy

Supported Versions

Version Supported
2.x Yes
< 2.0 No

Reporting a Vulnerability

To report a security vulnerability, please open a GitHub issue with the label security. For sensitive disclosures, email the maintainer directly rather than posting publicly.

Please include:

  • A description of the vulnerability and its potential impact
  • Steps to reproduce
  • Any suggested fix, if available

You can expect an initial response within 5 business days.

Security Considerations

API Token Handling

This server authenticates to Targetprocess using a bearer token set via the TP_TOKEN environment variable. The token is appended as a query parameter on every outbound request.

  • Never commit .env files or API tokens to source control.
  • Use .env.example as a template; keep actual credentials in .env (git-ignored).
  • Rotate the TP_TOKEN if it is accidentally exposed.

Environment Variables

All sensitive configuration (TP_TOKEN, TP_BASE_URL, TP_OWNER_ID, TP_PROJECT_ID, TP_TEAM_ID) is loaded from environment variables at startup. Ensure these are managed securely in your deployment environment (e.g., secrets manager, CI/CD secrets, not plain-text config files).

Stdio Transport

The MCP server communicates exclusively over stdio. It does not open any network ports and is not directly reachable over a network, which limits its attack surface to the process that spawns it (typically an MCP client such as Claude Desktop or Claude Code).

Input Validation

All tool inputs are validated with Zod schemas before reaching the Targetprocess API. Nonetheless, the server operates with whatever permissions the TP_TOKEN grants — apply the principle of least privilege when generating API tokens in Targetprocess.

Dependency Updates

Keep dependencies up to date to pick up security patches. Run npm audit periodically to identify known vulnerabilities in the dependency tree.

Known Limitations

  • The TP_TOKEN is passed as a URL query parameter, which may appear in HTTP server access logs on the Targetprocess side. Prefer private or self-hosted Targetprocess instances where log access is controlled.
  • No outbound request signing or mutual TLS is implemented; the server relies entirely on HTTPS and token-based auth provided by the Targetprocess platform.

There aren't any published security advisories