Ty
d6b74c42f6
Add dry-run-default connect dispatcher and per-integration scripts with gitignored local capability state, docs, and unit tests. Mutations require --apply and use nemohermes/openshell only.
42 lines
1.3 KiB
Markdown
42 lines
1.3 KiB
Markdown
# Vagaro
|
|
|
|
**Status:** Connect script implemented. Design: [design/mcp-integrations.md](../../design/mcp-integrations.md).
|
|
|
|
- **No public MCP** — REST + webhooks.
|
|
- Appointments, clients, services, staff.
|
|
- No unofficial scrape.
|
|
- **Connect:** operator `scripts/connect/connect-vagaro.sh`.
|
|
|
|
## Connect procedure
|
|
|
|
```bash
|
|
# Preview (default)
|
|
./scripts/connect.sh vagaro --dry-run
|
|
|
|
# Execute (prompts for credentials)
|
|
./scripts/connect.sh vagaro --apply
|
|
```
|
|
|
|
### What the script does
|
|
|
|
1. **Dry-run:** Shows API base URL, webhook port, and step-by-step procedure.
|
|
2. **Apply:**
|
|
- Prompts for Vagaro API Key, API Secret, and optional Webhook Secret.
|
|
- Stores credentials via `openshell provider set vagaro-*`.
|
|
- Verifies API connectivity (best-effort curl to `/v1/me`).
|
|
- Records status in `.local/capability_state.json`.
|
|
- Provides webhook URL guidance.
|
|
|
|
### Owner steps (browser only)
|
|
|
|
1. Create a Vagaro developer account at [developer.vagaro.com](https://developer.vagaro.com).
|
|
2. Register an application to obtain API credentials.
|
|
3. Configure webhook URL in the Vagaro dashboard.
|
|
4. Provide credentials to the operator.
|
|
|
|
### API configuration
|
|
|
|
- **API Base:** `https://api.vagaro.com`
|
|
- **Webhook port:** `9876` (configurable via `LUMINA_VAGARO_WEBHOOK_PORT`)
|
|
- **Webhook URL:** `https://<your-host>:9876/vagaro/webhook`
|