Troubleshooting

A tool call times out

Export renders a file, and document-wide reads and edits touch every block on every page. Both routinely exceed a default client timeout.

Set your client's tool timeout to at least 60 seconds.

Requests fail with no clear error

Check your platform's outbound host filter. Allow mcp.marq.com for the server and marq.com for the sign-in page. Allowing one but not the other fails silently.

Sign-in never completes

Authorization requires PKCE with S256. A client that does not send a code challenge is rejected at the authorization endpoint. Most MCP clients do this automatically; a hand-rolled one may not.

429 RATE_LIMITED

You have exceeded 30 requests per minute on that session. The response carries standard RateLimit-* headers and a Retry-After. Wait and retry — see Usage policy & limits.

The user is asked to sign in again mid-task

Access tokens last one hour. Your client should refresh silently using the refresh token. Being bounced to a sign-in page usually means the refresh token was not stored.

Can we connect once for the whole organization?

No. Every user authorizes individually.

Marq permissions differ from person to person — folder access, team membership, which brand kits and datasets they can see. A single shared credential would over-grant for some people and under-grant for others. Per-user authorization means the assistant reaches exactly what that person reaches.

An edit returned a 409

Two edit calls hit the same document at once. Batch edits into a single request, or run them serially. Reads can run in parallel. Retrying the same pattern reproduces it.

The assistant says a document is empty when it is not

The document is a template whose smart fields have not been filled, so its raw text is full of {{ }} expressions. Call dmes_GetSmartFields and apply values.

The brand kit returned assets that cannot be applied

Assets with a null schemaKey are not mapped to a brand role, so dmes_ApplyBranding has nothing to bind them to. Map them to a role in Marq first.

A template edit did not stick

Templates are not edited in place. Create a project from the template with document_CreateProjectFromTemplate and edit the project.