> For the complete documentation index, see [llms.txt](https://docs.moderncollections.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.moderncollections.io/integration-guides/overview.md).

# Overview

The reference tells you what each endpoint does. The guides show you how to use them together to accomplish a real business goal. Each guide:

* States a concrete outcome (e.g. "ingest overdue invoices nightly from your accounting system").
* Walks through the full integration shape with code.
* Calls out pitfalls and design decisions.

## When to read a guide vs. the reference

| Question                                                       | Where to go                                                                                           |
| -------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| "What fields does this endpoint accept?"                       | [REST API reference](/rest-api/overview.md)                                                           |
| "How do I structure my integration?"                           | Here                                                                                                  |
| "Why is my placement stuck in `pending_enrichment`?"           | [Error handling](/getting-started/error-handling.md), then a guide                                    |
| "How do I reconcile our AR system with what you've recovered?" | [Reconcile payments back to accounting](/integration-guides/reconcile-payments-back-to-accounting.md) |

## Guide catalog

| Guide                                                                                                 | What you'll build                                                                                                                                 | Time     |
| ----------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | -------- |
| [Ingest overdue invoices](/integration-guides/ingest-overdue-invoices.md)                             | A nightly job that batches overdue invoices from your AR system into our API via `POST /v1/placements` or `POST /v1/intake/csv/preview` + commit. | \~30 min |
| [Reconcile payments back to accounting](/integration-guides/reconcile-payments-back-to-accounting.md) | A webhook handler that closes invoices in your AR system when funds arrive. QuickBooks Online is the only first-class integration today.          | \~45 min |
| [Handle disputes end-to-end](/integration-guides/handle-disputes-end-to-end.md)                       | The dispute lifecycle: debtor files via portal -> creditor acknowledges. Resolution surfaces are still in flight.                                 | \~30 min |
| [Configure negotiation strategy](/integration-guides/configure-negotiation-strategy.md)               | Per-creditor `posture_default` plus per-placement `posture`. The expanded strategy-profile API is planned.                                        | \~15 min |
| [First-party SaaS onboarding](/integration-guides/multi-tenant-1p-onboarding.md)                      | Planned. The platform runs in 3P mode today; 1P is future state.                                                                                  | —        |
| [MCP agent quickstart](/integration-guides/mcp-agent-quickstart.md)                                   | Connect an MCP-capable agent (Claude Code, Claude Desktop, Cursor) to the `mc-api-mcp` stdio server and its 8 tools.                              | \~5 min  |

## See also

* [Getting Started](/getting-started/overview.md)
* [REST API reference](/rest-api/overview.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.moderncollections.io/integration-guides/overview.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.