applaunchflow 0.3.8 → 0.3.9

package/README.md

@@ -31,6 +31,23 @@ codex mcp get applaunchflow
 codex mcp remove applaunchflow
 ```
 
+### Claude Code
+
+The same one-command setup is available for Claude Code. It replaces a legacy
+AppLaunchFlow entry when necessary, adds the hosted HTTP connector, and opens
+OAuth sign-in:
+
+```bash
+npx -y applaunchflow connect claude
+```
+
+The equivalent native Claude Code commands are:
+
+```bash
+claude mcp add --transport http applaunchflow https://mcp.applaunchflow.com/mcp
+claude mcp login applaunchflow
+```
+
 ### ChatGPT
 
 ```bash
@@ -48,6 +65,22 @@ Use this Streamable HTTP endpoint and enable OAuth when prompted:
 https://mcp.applaunchflow.com/mcp
 ```
 
+### Claude Code plugin
+
+This repository is also a distributable Claude Code plugin. Its
+`.claude-plugin/plugin.json` manifest bundles the hosted OAuth connector from
+`.mcp.json`, so users do not need to copy a server configuration manually.
+
+To validate or try the plugin directly from a clone:
+
+```bash
+claude plugin validate . --strict
+claude --plugin-dir .
+```
+
+Claude Code starts the hosted connector when the plugin is enabled and opens
+the AppLaunchFlow OAuth flow when authentication is required.
+
 ## Hosted service
 
 The public Streamable HTTP service uses OAuth 2.1 authorization code flow with

package/build/cli-core.js

@@ -30,3 +30,28 @@ export function isHostedCodexConfig(value) {
 export function codexDisconnectArgs() {
     return ["mcp", "remove", APPLAUNCHFLOW_MCP_NAME];
 }
+export function claudeAddArgs() {
+    return [
+        "mcp",
+        "add",
+        "--transport",
+        "http",
+        APPLAUNCHFLOW_MCP_NAME,
+        APPLAUNCHFLOW_MCP_URL,
+    ];
+}
+export function claudeLoginArgs() {
+    return ["mcp", "login", APPLAUNCHFLOW_MCP_NAME];
+}
+export function claudeStatusArgs() {
+    return ["mcp", "get", APPLAUNCHFLOW_MCP_NAME];
+}
+export function claudeDisconnectArgs() {
+    return ["mcp", "remove", APPLAUNCHFLOW_MCP_NAME];
+}
+export function isHostedClaudeConfig(output) {
+    const normalized = output.replace(/\u001B\[[0-?]*[ -/]*[@-~]/g, "");
+    const hasHttpTransport = /^\s*Type:\s*http\s*$/im.test(normalized);
+    const configuredUrl = normalized.match(/^\s*URL:\s*(\S+)\s*$/im)?.[1];
+    return hasHttpTransport && configuredUrl === APPLAUNCHFLOW_MCP_URL;
+}

package/build/cli-core.test.js

@@ -1,6 +1,6 @@
 import assert from "node:assert/strict";
 import test from "node:test";
-import { APPLAUNCHFLOW_MCP_NAME, APPLAUNCHFLOW_MCP_URL, codexAddArgs, codexDisconnectArgs, codexInspectArgs, codexLoginArgs, codexStatusArgs, isHostedCodexConfig, } from "./cli-core.js";
+import { APPLAUNCHFLOW_MCP_NAME, APPLAUNCHFLOW_MCP_URL, claudeAddArgs, claudeDisconnectArgs, claudeLoginArgs, claudeStatusArgs, codexAddArgs, codexDisconnectArgs, codexInspectArgs, codexLoginArgs, codexStatusArgs, isHostedClaudeConfig, isHostedCodexConfig, } from "./cli-core.js";
 test("Codex convenience commands use the hosted OAuth connector", () => {
     assert.deepEqual(codexAddArgs(), [
         "mcp",
@@ -23,6 +23,36 @@ test("Codex convenience commands use the hosted OAuth connector", () => {
         "applaunchflow",
     ]);
 });
+test("Claude Code convenience commands use the hosted OAuth connector", () => {
+    assert.deepEqual(claudeAddArgs(), [
+        "mcp",
+        "add",
+        "--transport",
+        "http",
+        APPLAUNCHFLOW_MCP_NAME,
+        APPLAUNCHFLOW_MCP_URL,
+    ]);
+    assert.deepEqual(claudeLoginArgs(), ["mcp", "login", "applaunchflow"]);
+    assert.deepEqual(claudeStatusArgs(), ["mcp", "get", "applaunchflow"]);
+    assert.deepEqual(claudeDisconnectArgs(), [
+        "mcp",
+        "remove",
+        "applaunchflow",
+    ]);
+});
+test("detects whether Claude Code already uses the hosted connector", () => {
+    assert.equal(isHostedClaudeConfig(`applaunchflow:
+  Scope: Local config
+  Type: http
+  URL: ${APPLAUNCHFLOW_MCP_URL}`), true);
+    assert.equal(isHostedClaudeConfig(`applaunchflow:
+  Type: stdio
+  Command: npx -y @applaunchflow/mcp@latest`), false);
+    assert.equal(isHostedClaudeConfig(`applaunchflow:
+  Type: http
+  URL: https://example.com/mcp`), false);
+    assert.equal(isHostedClaudeConfig(`\u001b[32mType: http\u001b[0m\nURL: ${APPLAUNCHFLOW_MCP_URL}`), true);
+});
 test("detects whether Codex already uses the hosted connector", () => {
     assert.equal(isHostedCodexConfig({
         transport: {

package/build/cli.js

@@ -1,11 +1,12 @@
 #!/usr/bin/env node
 import { spawnSync } from "node:child_process";
-import { APPLAUNCHFLOW_MCP_URL, codexAddArgs, codexDisconnectArgs, codexInspectArgs, codexLoginArgs, codexStatusArgs, isHostedCodexConfig, } from "./cli-core.js";
+import { APPLAUNCHFLOW_MCP_URL, claudeAddArgs, claudeDisconnectArgs, claudeLoginArgs, claudeStatusArgs, codexAddArgs, codexDisconnectArgs, codexInspectArgs, codexLoginArgs, codexStatusArgs, isHostedClaudeConfig, isHostedCodexConfig, } from "./cli-core.js";
 function printHelp() {
     console.log(`AppLaunchFlow MCP
 
 Usage:
   applaunchflow connect codex
+  applaunchflow connect claude
   applaunchflow connect chatgpt
   applaunchflow status
   applaunchflow disconnect
@@ -20,6 +21,15 @@ function runCodex(args) {
         throw new Error(`Codex exited with status ${result.status ?? "unknown"}`);
     }
 }
+function runClaude(args) {
+    const result = spawnSync("claude", args, { stdio: "inherit" });
+    if (result.error) {
+        throw new Error(`Could not run Claude Code: ${result.error.message}`);
+    }
+    if (result.status !== 0) {
+        throw new Error(`Claude Code exited with status ${result.status ?? "unknown"}`);
+    }
+}
 function getCodexConfiguration() {
     const result = spawnSync("codex", codexInspectArgs(), {
         encoding: "utf8",
@@ -51,6 +61,29 @@ function connectCodex() {
     }
     runCodex(codexLoginArgs());
 }
+function getClaudeConfiguration() {
+    const result = spawnSync("claude", claudeStatusArgs(), {
+        encoding: "utf8",
+        stdio: ["ignore", "pipe", "ignore"],
+    });
+    if (result.error) {
+        throw new Error(`Could not run Claude Code: ${result.error.message}`);
+    }
+    if (result.status !== 0)
+        return "missing";
+    return isHostedClaudeConfig(result.stdout) ? "hosted" : "legacy";
+}
+function connectClaude() {
+    const configuration = getClaudeConfiguration();
+    if (configuration === "legacy") {
+        console.log("Replacing the legacy local AppLaunchFlow MCP configuration...");
+        runClaude(claudeDisconnectArgs());
+    }
+    if (configuration !== "hosted") {
+        runClaude(claudeAddArgs());
+    }
+    runClaude(claudeLoginArgs());
+}
 function connectChatGpt() {
     console.log(`Add a custom MCP connector in ChatGPT using this URL:\n${APPLAUNCHFLOW_MCP_URL}`);
 }
@@ -60,6 +93,10 @@ function main() {
         connectCodex();
         return;
     }
+    if (command === "connect" && target === "claude") {
+        connectClaude();
+        return;
+    }
     if (command === "connect" && target === "chatgpt") {
         connectChatGpt();
         return;

package/build/cli.test.js

@@ -0,0 +1,57 @@
+import assert from "node:assert/strict";
+import { chmod, mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { spawnSync } from "node:child_process";
+import test from "node:test";
+import { fileURLToPath } from "node:url";
+import { APPLAUNCHFLOW_MCP_URL } from "./cli-core.js";
+async function runConnectClaude(getOutput, getStatus = 0) {
+    const directory = await mkdtemp(join(tmpdir(), "applaunchflow-cli-"));
+    const executable = join(directory, "claude");
+    const logPath = join(directory, "claude.log");
+    await writeFile(executable, `#!/bin/sh
+printf '%s\\n' "$*" >> "$CLAUDE_TEST_LOG"
+if [ "$*" = "mcp get applaunchflow" ]; then
+  printf '%s' "$CLAUDE_GET_OUTPUT"
+  exit "$CLAUDE_GET_STATUS"
+fi
+`);
+    await chmod(executable, 0o755);
+    try {
+        const cliPath = fileURLToPath(new URL("./cli.js", import.meta.url));
+        const result = spawnSync(process.execPath, [cliPath, "connect", "claude"], {
+            encoding: "utf8",
+            env: {
+                ...process.env,
+                PATH: `${directory}:${process.env.PATH ?? ""}`,
+                CLAUDE_TEST_LOG: logPath,
+                CLAUDE_GET_OUTPUT: getOutput,
+                CLAUDE_GET_STATUS: String(getStatus),
+            },
+        });
+        assert.equal(result.status, 0, result.stderr);
+        return (await readFile(logPath, "utf8")).trim().split("\n");
+    }
+    finally {
+        await rm(directory, { recursive: true, force: true });
+    }
+}
+test("Claude helper adds a missing connector and starts OAuth", async () => {
+    assert.deepEqual(await runConnectClaude("", 1), [
+        "mcp get applaunchflow",
+        `mcp add --transport http applaunchflow ${APPLAUNCHFLOW_MCP_URL}`,
+        "mcp login applaunchflow",
+    ]);
+});
+test("Claude helper replaces a legacy connector before starting OAuth", async () => {
+    assert.deepEqual(await runConnectClaude("Type: stdio\nCommand: npx legacy-server"), [
+        "mcp get applaunchflow",
+        "mcp remove applaunchflow",
+        `mcp add --transport http applaunchflow ${APPLAUNCHFLOW_MCP_URL}`,
+        "mcp login applaunchflow",
+    ]);
+});
+test("Claude helper keeps the hosted connector and refreshes OAuth", async () => {
+    assert.deepEqual(await runConnectClaude(`Type: http\nURL: ${APPLAUNCHFLOW_MCP_URL}\nStatus: Connected`), ["mcp get applaunchflow", "mcp login applaunchflow"]);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "applaunchflow",
-  "version": "0.3.8",
+  "version": "0.3.9",
   "description": "Hosted OAuth MCP connector for AppLaunchFlow.",
   "license": "MIT",
   "repository": {