Skip to content

Build an app

Build with an AI assistant (MCP)

On this page

Connect an AI assistant to your developer account and let it help you build apps: write and check a manifest, create the draft, upload images, test your webhook URL and submit. It uses the developer MCP server:

Text
https://developers.bizisy.com/mcp

It takes an access token (bzd_…) in the Authorization header and offers the developer actions that token's scopes allow. It is a different server from a company's MCP (/mcp/manage, /mcp/me): it never reaches any company's data.

Connect your client#

Create a token in Account → Access tokens (apps:write to let the assistant create and change apps, apps:read to only read them), then add the server.

Claude Code:

Shell
claude mcp add --transport http bizisy-dev https://developers.bizisy.com/mcp --header "Authorization: Bearer bzd_…"

Clients configured with JSON (Claude Desktop through a remote-server connector, Cursor, VS Code and others; the exact key names vary by client):

JSON
{
  "mcpServers": {
    "bizisy-dev": {
      "url": "https://developers.bizisy.com/mcp",
      "headers": { "Authorization": "Bearer bzd_…" }
    }
  }
}

Keep the token out of shared files: use your client's secret or environment settings when it has them.

What the assistant reads first#

The server's skill guide, skill://developers/build-an-app (clients that can't read MCP resources call platform_skills_get), walks it through building an app:

  1. Ask who owns the app (you or one of your organizations).
  2. Write the manifest and check it with developers_apps_manifest_validate.
  3. Create the draft with developers_apps_create (a dry run first).
  4. Check the webhook receiver with developers_apps_webhook_test.
  5. Send you to the console to test it: installing happens on a company's consent screen in a browser, in a company where you are an owner or admin.
  6. Submit it with developers_apps_submit.

What it can't do#

The assistant can't install apps, and it can't do what stays in the console: access tokens, client secrets, deleting or transferring apps, organizations, members and invitations, the sandbox and your account. When you ask for one, it says so and gives you the console link.

Everything it changes is in your Activity (Account → Activity), marked with the token's name.

Things to ask#

  • "Create an app owned by Example Payroll that reads people and gets person.hired events, with my callback at https://example.com/bizisy/callback."
  • "Check my manifest for a review and fix what's missing."
  • "Does my webhook receiver answer?"
  • "Submit Payroll Sync for review with notes on how to test it."

Something missing or wrong on this page? Write to hello@bizisy.com.

Developer docs