Getting started
Getting started
Choose an integration
Pick a personal access token, an IDP client, or MCP before you write the first request.
Three ways to integrate. Use one credential for one job.
| Job | Credential | Start here |
|---|---|---|
| Your server reads or writes businesses the token's user can access | Personal access token | Quick start |
| Your app signs a NoCFO user in and calls the API as that user | IDP client | Request a client |
| Claude, ChatGPT, Claude Code, or Codex works in the user's businesses | MCP, browser OAuth | AI connection |
Do not reuse a credential across these jobs. A personal access token sent to https://mcp.nocfo.io is rejected. An MCP access token sent to https://api.nocfo.io is not a personal access token. An IDP client id is not a token. You still complete a login before you hold an access token.
After you pick
- Use the testing environment until the integration is ready.
- For a token integration, follow the quick start and keep the
slugfromGET /v1/business/. - For a user-login integration, email dev@nocfo.io before you code the callback. The reply has the client id.
- Read Authentication for the
Authorization: Tokenheader, including the one-hour JWT.
The operation pages under API reference are generated from the production schema. Guides on this site link to them. If a guide and a reference page disagree, follow the reference page.