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

# Developers

Developer guide to the Yedric widget: embed it, secure sessions with HMAC, use the JavaScript API, and connect webhooks, custom apps and MCP.

## Widget

The widget is a single script tag and a web component, no build step, no dependencies. Add it to your page and it just works. From there you can theme it, wire up JavaScript events, or lock sessions to individual users with HMAC signing.

* [Embedding the Widget](https://docs.yedric.ai/developers/embedding-widget/): quick start, attribute reference, common mistakes
* [Secure Mode](https://docs.yedric.ai/developers/secure-mode/): HMAC signing to scope sessions per user; Node / PHP / SubtleCrypto examples
* [Advanced Configuration](https://docs.yedric.ai/developers/advanced-configuration/): theming, layout, iframe/Shopify, client-side tool handling, programmatic open, debug
* [JavaScript API](https://docs.yedric.ai/developers/javascript-api/): `window.Yedric` methods, events, TypeScript types
* [Client Events](https://docs.yedric.ai/developers/client-events/): report things that happen in your own UI to the assistant, and let it react
* [MCP Server](https://docs.yedric.ai/developers/mcp-server/): manage assistants and read conversation data from Claude Desktop, Claude Code, and other MCP clients
* [Webhooks](https://docs.yedric.ai/developers/webhooks/): subscribe to events, verify the signature, and handle retries
* [Custom Apps](https://docs.yedric.ai/developers/custom-apps/): render your own panel beside a conversation

## In this section

- [Embedding the Widget](https://docs.yedric.ai/developers/embedding-widget.md)
- [Secure Mode](https://docs.yedric.ai/developers/secure-mode.md)
- [Advanced Configuration](https://docs.yedric.ai/developers/advanced-configuration.md)
- [JavaScript API](https://docs.yedric.ai/developers/javascript-api.md)
- [Client Events](https://docs.yedric.ai/developers/client-events.md)
- [MCP Server](https://docs.yedric.ai/developers/mcp-server.md)
- [Webhooks](https://docs.yedric.ai/developers/webhooks.md)
- [Custom Apps](https://docs.yedric.ai/developers/custom-apps.md)