chore: update .dockerignore and Zendesk MCP docs

Added new files to .dockerignore for privacy and cleanliness. Enhanced documentation by including details about the new Zendesk MCP server, its architecture, configuration, and usage.

Author: winromulus

.dockerignore

@@ -19,6 +19,9 @@
 **/node_modules
 **/npm-debug.log
 **/obj
+**/appsettings.Development.json
+**/appsettings.*.local.json
+.artifacts
 **/secrets.dev.yaml
 **/values.dev.yaml
 LICENSE

CLAUDE.md

@@ -84,7 +84,9 @@ registration, health checks, OpenTelemetry) and follows a fixed shape — study
 A newer Zendesk vertical spans the layers: `ES.FX.Zendesk` (typed Zendesk API client,
 [`docs/libraries/zendesk-client.md`](docs/libraries/zendesk-client.md)), `ES.FX.Ignite.Zendesk` (its Spark,
 [`docs/ignite/sparks/zendesk.md`](docs/ignite/sparks/zendesk.md)), and `ES.FX.Zendesk.MCP.Host` (the
-deployable MCP server app noted above; its MCP wiring is host-inline — there is no MCP Spark package).
+deployable MCP server app exposing the client as 168 read/write MCP tools,
+[`docs/libraries/zendesk-mcp-server.md`](docs/libraries/zendesk-mcp-server.md); its MCP wiring is
+host-inline — there is no MCP Spark package).
 
 ## Conventions & Build Configuration
 

docs/development/hosting.md

@@ -67,14 +67,20 @@ Everything lives in the `ES.FX.Hosting.Lifetime` namespace.
 
 ## Exit codes
 
-`RunAsync` maps three outcomes onto the returned exit code:
+`RunAsync` maps these outcomes onto the returned exit code:
 
 | Outcome | Returned code | Logged as |
 | --- | --- | --- |
 | Delegate returns normally | the value your delegate returns | `Debug` — "Program completed with exit code …" |
 | Delegate throws `ControlledExitException` | `ex.ExitCode` | `Debug` — "Program exited controlled …" |
+| Delegate throws `HostAbortedException` | *(rethrown, no code)* | not logged — see below |
 | Delegate throws any other exception | `1` | `Critical` — "Program terminated unexpectedly" (with the exception) |
 
+`HostAbortedException` is deliberately **not** swallowed: design-time tooling (the EF Core tools) and test
+hosts (`WebApplicationFactory`) abort the host on purpose and require the exception to propagate out of `Main`
+to take over the captured host. Treating it as a crash would break `dotnet ef` and integration tests against
+hosts built on `ProgramEntry`.
+
 Because you return the exit code from the delegate, wire it straight into the process exit code by returning the result of `RunAsync` from your top-level statements (as in the examples on this page).
 
 ## Controlled exit

docs/ignite/sparks/zendesk.md

@@ -275,6 +275,7 @@ the status code on failure. Response bodies are never logged.
 ## See also
 
 - [Zendesk API client](../../libraries/zendesk-client.md) — the client surface, OAuth model, and error handling.
+- [Zendesk MCP server](../../libraries/zendesk-mcp-server.md) — a deployable MCP host built on this Spark.
 - [Ignite overview](../index.md)
 - [Sparks catalog](./index.md)
 - [Azure Key Vault Secrets Spark](./azure-keyvault-secrets.md) — for the OAuth client secret.

docs/index.md

@@ -68,6 +68,7 @@ For the full walkthrough, see the [Quickstart](./getting-started/quickstart.md)
 | Add a helper for a specific third-party library | [Additions catalog](./additions/index.md) |
 | Use the core error-handling and primitive types | [Results & Problems](./development/results-and-problems.md), [Primitives](./development/primitives.md) |
 | Use a standalone feature library | [Transactional Outbox](./libraries/transactional-outbox.md), [Migrations](./libraries/migrations.md), [Zendesk client](./libraries/zendesk-client.md) |
+| Expose Zendesk to an AI agent (MCP server) | [Zendesk MCP server](./libraries/zendesk-mcp-server.md) |
 | Build, test, or contribute to the framework | [Development guide](./development/index.md) |
 
 ## See also

docs/libraries/index.md

@@ -16,7 +16,7 @@ into Ignite when you want it to.
 | [**Migrations**](./migrations.md) | `ES.FX.Migrations` (+ `ES.FX.Ignite.Migrations`) | A DI-driven migration runner: implement `IMigrationsTask`, register it, and a hosted service applies every task at startup. |
 | [**Zendesk API client**](./zendesk-client.md) | `ES.FX.Zendesk` (+ `ES.FX.Ignite.Zendesk` Spark) | A typed, OAuth-authenticated client for the Zendesk Support REST API — resource-grouped operations, typed errors with `Retry-After`, and OpenTelemetry tracing. |
 
-Both libraries are independently consumable. Each has its own page below with the full end-to-end walkthrough.
+Each library is independently consumable and has its own page below with the full end-to-end walkthrough.
 
 ---
 
@@ -70,6 +70,11 @@ multi-tenant instances, the resource areas, configuration and secret hygiene, th
 handling and rate limits, and observability. The [Zendesk Spark](../ignite/sparks/zendesk.md) page
 covers the Ignite integration (config binding, startup validation, live health check, tracing).
 
+For exposing Zendesk to an AI agent, the [Zendesk MCP server](./zendesk-mcp-server.md) is a deployable
+[Model Context Protocol](https://modelcontextprotocol.io) host — built on this client and Ignite — that
+publishes the full client surface as 168 read and write MCP tools, with execution-mode gating and Origin
+validation. It is an application, not a package.
+
 ---
 
 ## See also
@@ -78,6 +83,7 @@ covers the Ignite integration (config binding, startup validation, live health c
 - [Migrations](./migrations.md)
 - [Zendesk API client](./zendesk-client.md)
 - [Zendesk Spark](../ignite/sparks/zendesk.md)
+- [Zendesk MCP server](./zendesk-mcp-server.md)
 - [Transactional Outbox — EF Core additions](../additions/entity-framework-core.md)
 - [MassTransit additions](../additions/masstransit.md)
 - [Entity Framework Core Spark](../ignite/sparks/entity-framework-core.md)

docs/libraries/zendesk-client.md

@@ -378,6 +378,7 @@ counts and durations for the underlying `HttpClient`.
 ## See also
 
 - [Zendesk Spark](../ignite/sparks/zendesk.md) — the Ignite integration: config binding, health check, tracing.
+- [Zendesk MCP server](./zendesk-mcp-server.md) — a deployable MCP host exposing this client as 168 agent tools.
 - [Framework libraries](./index.md)
 - [Ignite overview](../ignite/index.md)
 - [Zendesk API reference](https://developer.zendesk.com/api-reference/)