forcedotcom/sf-skills / skills/experience-app-mcp-delivery-generate
experience-app-mcp-delivery-generate
VerifiedPackage and deliver an existing Salesforce hosted MCP server/App MCP for an Experience Site as an MCP configuration file or a Claude plugin repository. Discover the serving URL and External Client Application client ID, generate client configuration, optionally bundle skills in a plugin, and provide local testing and private GitHub handoff instructions. Plugin packaging supports Claude only; reject requests for Codex, ChatGPT, or other plugin platforms. Use for connecting clients and packaging delivery, not for creating or activating the Salesforce MCP server.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 16.5 KB |
| references/eca-consumer-key.md | markdown | 2.1 KB |
| references/mcp-config-delivery.md | markdown | 2.6 KB |
| references/plugin-format-and-publishing.md | markdown | 8.5 KB |
| scripts/developer_name.mjs | script | 464 B |
| scripts/discover_mcp_context.mjsexecutable | script | 6.0 KB |
| scripts/generate_mcp_config.mjsexecutable | script | 1.5 KB |
| scripts/generate_plugin.mjsexecutable | script | 10.8 KB |
| scripts/mcp_config.mjs | script | 3.9 KB |
| scripts/preflight.mjsexecutable | script | 5.0 KB |
| scripts/retrieve_eca_consumer_key.mjsexecutable | script | 5.1 KB |
references/eca-consumer-key.md
View on GitHub# ECA client ID lookup
This delivery skill owns consumer-key retrieval. Run its helper from the selected SFDX project root; `<skill-dir>` is this skill's absolute directory.
```bash
node "<skill-dir>/scripts/retrieve_eca_consumer_key.mjs" <target-org-alias> <ECA_DEV_NAME> --json
```
The helper reads the project's `sourceApiVersion`, queries `ExternalClientApplication` by exact `DeveloperName`, and requests only the public key using GET `/services/data/v<version>/apps/oauth/credentials/<ECA-record-id>?part=key`. Do not query a `ConsumerKey` sObject field or retrieve a consumer secret.
Default successful output is the public consumer key. With `--json`, the response contains `apiVersion`, `ecaDeveloperName`, `ecaId`, `oauthConsumerId`, and `clientId`. Only `clientId` is the public OAuth client ID; the other IDs identify Salesforce records. Reuse a successful same-session lookup for the same selected org and ECA. Never copy access or refresh tokens into an output.
### Consumer-key retrieval
| Exit | Meaning | Next step |
|---|---|---|
| `2` | Lookup, API, or response validation failed | Resolve the reported failure; it doesn't establish that the ECA or consumer is missing |
| `3` | The query succeeded and no ECA matched the DeveloperName | Confirm the exact ECA name and deployment; allow for propagation before retrying |
| `4` | An OAuth consumer must be selected | Show the returned consumer names and IDs and ask the user which is intended |
After the user selects an OAuth consumer, rerun the helper owned by `experience-app-mcp-delivery-generate` with that ID. Run it from the selected SFDX project root:
```bash
node "<skill-dir>/scripts/retrieve_eca_consumer_key.mjs" <target-org-alias> <ECA_DEV_NAME> <oauth-consumer-id>
```
For a permission error, report that the authenticated user needs `View External Client App Consumer Secrets in Metadata` and point the user to the ECA OAuth consumer details in Setup. Retry only `retrieve_eca_consumer_key.mjs` after resolving the failure, or have the user read the consumer key from that screen. Never retrieve the consumer secret. Use the lookup command and output contract above.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |