@line-harness/mcp-server 0.5.0 → 0.6.1

package/dist/index.js

@@ -1150,6 +1150,287 @@ function registerListCrmObjects(server2) {
   );
 }
 
+// src/tools/manage-ad-platforms.ts
+import { z as z15 } from "zod";
+function registerManageAdPlatforms(server2) {
+  server2.tool(
+    "manage_ad_platforms",
+    "Manage ad platform integrations for conversion tracking. Supports Meta (Facebook/Instagram), X (Twitter), Google Ads, and TikTok. Use 'list' to see configured platforms, 'create' to add a new one, 'update' to modify settings, 'delete' to remove, or 'test' to verify the connection.",
+    {
+      action: z15.enum(["list", "create", "update", "delete", "test"]).describe("Action to perform"),
+      platformId: z15.string().optional().describe("Platform ID (required for 'update' and 'delete')"),
+      name: z15.enum(["meta", "x", "google", "tiktok"]).optional().describe("Platform name (required for 'create' and 'test')"),
+      displayName: z15.string().optional().describe("Display name for the platform (e.g. 'Meta\u5E83\u544A')"),
+      config: z15.record(z15.unknown()).optional().describe(
+        "Platform config JSON. Meta: {pixel_id, access_token, test_event_code?}. X: {pixel_id, api_key, api_secret}. Google: {customer_id, conversion_action_id, oauth_token}. TikTok: {pixel_code, access_token}"
+      ),
+      isActive: z15.boolean().optional().describe("Enable/disable the platform (for 'update')"),
+      eventName: z15.string().optional().describe("Event name for test conversion (for 'test', e.g. 'Lead')"),
+      friendId: z15.string().optional().describe("Friend ID for test conversion (for 'test')")
+    },
+    async ({ action, platformId, name, displayName, config, isActive, eventName, friendId }) => {
+      try {
+        const client = getClient();
+        switch (action) {
+          case "list": {
+            const platforms = await client.adPlatforms.list();
+            return {
+              content: [
+                {
+                  type: "text",
+                  text: JSON.stringify(
+                    {
+                      success: true,
+                      count: platforms.length,
+                      platforms
+                    },
+                    null,
+                    2
+                  )
+                }
+              ]
+            };
+          }
+          case "create": {
+            if (!name) throw new Error("name is required for create action");
+            if (!config)
+              throw new Error("config is required for create action");
+            const platform = await client.adPlatforms.create({
+              name,
+              displayName,
+              config
+            });
+            return {
+              content: [
+                {
+                  type: "text",
+                  text: JSON.stringify({ success: true, platform }, null, 2)
+                }
+              ]
+            };
+          }
+          case "update": {
+            if (!platformId)
+              throw new Error("platformId is required for update action");
+            const platform = await client.adPlatforms.update(platformId, {
+              name,
+              displayName,
+              config,
+              isActive
+            });
+            return {
+              content: [
+                {
+                  type: "text",
+                  text: JSON.stringify({ success: true, platform }, null, 2)
+                }
+              ]
+            };
+          }
+          case "delete": {
+            if (!platformId)
+              throw new Error("platformId is required for delete action");
+            await client.adPlatforms.delete(platformId);
+            return {
+              content: [
+                {
+                  type: "text",
+                  text: JSON.stringify({
+                    success: true,
+                    message: `Platform ${platformId} deleted`
+                  })
+                }
+              ]
+            };
+          }
+          case "test": {
+            if (!name) throw new Error("name is required for test action");
+            if (!eventName)
+              throw new Error("eventName is required for test action");
+            const result = await client.adPlatforms.test(
+              name,
+              eventName,
+              friendId
+            );
+            return {
+              content: [
+                {
+                  type: "text",
+                  text: JSON.stringify({ success: true, ...result }, null, 2)
+                }
+              ]
+            };
+          }
+          default:
+            throw new Error(`Unknown action: ${action}`);
+        }
+      } catch (error) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(
+                { success: false, error: String(error) },
+                null,
+                2
+              )
+            }
+          ],
+          isError: true
+        };
+      }
+    }
+  );
+}
+
+// src/tools/get-conversion-logs.ts
+import { z as z16 } from "zod";
+function registerGetConversionLogs(server2) {
+  server2.tool(
+    "get_conversion_logs",
+    "View ad conversion send logs for a specific platform. Shows the history of conversion events sent to Meta CAPI, X, Google Ads, or TikTok, including status (sent/failed) and error details.",
+    {
+      platformId: z16.string().describe(
+        "Ad platform ID to get logs for. Use manage_ad_platforms with action 'list' first to get the ID."
+      ),
+      limit: z16.number().optional().default(50).describe("Maximum number of logs to return (default: 50)")
+    },
+    async ({ platformId, limit }) => {
+      try {
+        const client = getClient();
+        const logs = await client.adPlatforms.getLogs(platformId, limit);
+        const summary = {
+          total: logs.length,
+          sent: logs.filter((l) => l.status === "sent").length,
+          failed: logs.filter((l) => l.status === "failed").length
+        };
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(
+                { success: true, summary, logs },
+                null,
+                2
+              )
+            }
+          ]
+        };
+      } catch (error) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(
+                { success: false, error: String(error) },
+                null,
+                2
+              )
+            }
+          ],
+          isError: true
+        };
+      }
+    }
+  );
+}
+
+// src/tools/manage-staff.ts
+import { z as z17 } from "zod";
+function registerManageStaff(server2) {
+  server2.tool(
+    "manage_staff",
+    "\u30B9\u30BF\u30C3\u30D5\u30A2\u30AB\u30A6\u30F3\u30C8\u306E\u8FFD\u52A0\u30FB\u4E00\u89A7\u30FB\u66F4\u65B0\u30FB\u524A\u9664\u30FBAPI\u30AD\u30FC\u518D\u751F\u6210\u3002\u30AA\u30FC\u30CA\u30FC\u6A29\u9650\u304C\u5FC5\u8981\u3067\u3059\u3002",
+    {
+      action: z17.enum(["create", "list", "get", "update", "delete", "regenerate_key", "me"]).describe("Action to perform"),
+      name: z17.string().optional().describe("Staff name (for 'create' action)"),
+      email: z17.string().nullable().optional().describe("Staff email (optional, null to clear)"),
+      role: z17.enum(["admin", "staff"]).optional().describe("Staff role (for 'create'/'update')"),
+      staffId: z17.string().optional().describe("Staff ID (for 'get','update','delete','regenerate_key')"),
+      isActive: z17.boolean().optional().describe("Activate/deactivate (for 'update')")
+    },
+    async ({ action, name, email, role, staffId, isActive }) => {
+      try {
+        const client = getClient();
+        if (action === "me") {
+          const profile = await client.staff.me();
+          return {
+            content: [{ type: "text", text: JSON.stringify({ success: true, profile }, null, 2) }]
+          };
+        }
+        if (action === "list") {
+          const members = await client.staff.list();
+          return {
+            content: [{ type: "text", text: JSON.stringify({ success: true, members }, null, 2) }]
+          };
+        }
+        if (action === "create") {
+          if (!name) throw new Error("name is required for create action");
+          if (!role) throw new Error("role is required for create action");
+          const member = await client.staff.create({ name, email, role });
+          return {
+            content: [{
+              type: "text",
+              text: JSON.stringify({
+                success: true,
+                member,
+                note: "API\u30AD\u30FC\u306F\u4E00\u5EA6\u3060\u3051\u8868\u793A\u3055\u308C\u307E\u3059\u3002\u5B89\u5168\u306B\u4FDD\u7BA1\u3057\u3066\u304F\u3060\u3055\u3044\u3002"
+              }, null, 2)
+            }]
+          };
+        }
+        if (action === "get") {
+          if (!staffId) throw new Error("staffId is required for get action");
+          const member = await client.staff.get(staffId);
+          return {
+            content: [{ type: "text", text: JSON.stringify({ success: true, member }, null, 2) }]
+          };
+        }
+        if (action === "update") {
+          if (!staffId) throw new Error("staffId is required for update action");
+          const updates = {};
+          if (name !== void 0) updates.name = name;
+          if (email !== void 0) updates.email = email;
+          if (role !== void 0) updates.role = role;
+          if (isActive !== void 0) updates.isActive = isActive;
+          const member = await client.staff.update(staffId, updates);
+          return {
+            content: [{ type: "text", text: JSON.stringify({ success: true, member }, null, 2) }]
+          };
+        }
+        if (action === "delete") {
+          if (!staffId) throw new Error("staffId is required for delete action");
+          await client.staff.delete(staffId);
+          return {
+            content: [{ type: "text", text: JSON.stringify({ success: true, deleted: staffId }, null, 2) }]
+          };
+        }
+        if (action === "regenerate_key") {
+          if (!staffId) throw new Error("staffId is required for regenerate_key action");
+          const result = await client.staff.regenerateKey(staffId);
+          return {
+            content: [{
+              type: "text",
+              text: JSON.stringify({
+                success: true,
+                staffId,
+                newApiKey: result.apiKey,
+                note: "\u65B0\u3057\u3044API\u30AD\u30FC\u306F\u4E00\u5EA6\u3060\u3051\u8868\u793A\u3055\u308C\u307E\u3059\u3002\u5B89\u5168\u306B\u4FDD\u7BA1\u3057\u3066\u304F\u3060\u3055\u3044\u3002"
+              }, null, 2)
+            }]
+          };
+        }
+        throw new Error(`Unknown action: ${action}`);
+      } catch (error) {
+        return {
+          content: [{ type: "text", text: JSON.stringify({ success: false, error: String(error) }, null, 2) }],
+          isError: true
+        };
+      }
+    }
+  );
+}
+
 // src/tools/index.ts
 function registerAllTools(server2) {
   registerSendMessage(server2);
@@ -1166,6 +1447,9 @@ function registerAllTools(server2) {
   registerGetLinkClicks(server2);
   registerAccountSummary(server2);
   registerListCrmObjects(server2);
+  registerManageAdPlatforms(server2);
+  registerGetConversionLogs(server2);
+  registerManageStaff(server2);
 }
 
 // src/resources/index.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@line-harness/mcp-server",
-  "version": "0.5.0",
+  "version": "0.6.1",
   "type": "module",
   "bin": {
     "line-harness-mcp": "./dist/index.js"
@@ -11,7 +11,7 @@
     "dev": "tsup --watch"
   },
   "dependencies": {
-    "@line-harness/sdk": "^0.1.0",
+    "@line-harness/sdk": "^0.2.1",
     "@modelcontextprotocol/sdk": "^1.12.1",
     "zod": "^3.24.4"
   },

package/src/tools/get-conversion-logs.ts

@@ -0,0 +1,61 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { getClient } from "../client.js";
+
+export function registerGetConversionLogs(server: McpServer): void {
+  server.tool(
+    "get_conversion_logs",
+    "View ad conversion send logs for a specific platform. Shows the history of conversion events sent to Meta CAPI, X, Google Ads, or TikTok, including status (sent/failed) and error details.",
+    {
+      platformId: z
+        .string()
+        .describe(
+          "Ad platform ID to get logs for. Use manage_ad_platforms with action 'list' first to get the ID.",
+        ),
+      limit: z
+        .number()
+        .optional()
+        .default(50)
+        .describe("Maximum number of logs to return (default: 50)"),
+    },
+    async ({ platformId, limit }) => {
+      try {
+        const client = getClient();
+        const logs = await client.adPlatforms.getLogs(platformId, limit);
+
+        const summary = {
+          total: logs.length,
+          sent: logs.filter((l) => l.status === "sent").length,
+          failed: logs.filter((l) => l.status === "failed").length,
+        };
+
+        return {
+          content: [
+            {
+              type: "text" as const,
+              text: JSON.stringify(
+                { success: true, summary, logs },
+                null,
+                2,
+              ),
+            },
+          ],
+        };
+      } catch (error) {
+        return {
+          content: [
+            {
+              type: "text" as const,
+              text: JSON.stringify(
+                { success: false, error: String(error) },
+                null,
+                2,
+              ),
+            },
+          ],
+          isError: true,
+        };
+      }
+    },
+  );
+}

package/src/tools/index.ts

@@ -13,6 +13,9 @@ import { registerGetFormSubmissions } from "./get-form-submissions.js";
 import { registerGetLinkClicks } from "./get-link-clicks.js";
 import { registerAccountSummary } from "./account-summary.js";
 import { registerListCrmObjects } from "./list-crm-objects.js";
+import { registerManageAdPlatforms } from "./manage-ad-platforms.js";
+import { registerGetConversionLogs } from "./get-conversion-logs.js";
+import { registerManageStaff } from "./manage-staff.js";
 
 export function registerAllTools(server: McpServer): void {
   registerSendMessage(server);
@@ -29,4 +32,7 @@ export function registerAllTools(server: McpServer): void {
   registerGetLinkClicks(server);
   registerAccountSummary(server);
   registerListCrmObjects(server);
+  registerManageAdPlatforms(server);
+  registerGetConversionLogs(server);
+  registerManageStaff(server);
 }

package/src/tools/manage-ad-platforms.ts

@@ -0,0 +1,170 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { getClient } from "../client.js";
+
+export function registerManageAdPlatforms(server: McpServer): void {
+  server.tool(
+    "manage_ad_platforms",
+    "Manage ad platform integrations for conversion tracking. Supports Meta (Facebook/Instagram), X (Twitter), Google Ads, and TikTok. Use 'list' to see configured platforms, 'create' to add a new one, 'update' to modify settings, 'delete' to remove, or 'test' to verify the connection.",
+    {
+      action: z
+        .enum(["list", "create", "update", "delete", "test"])
+        .describe("Action to perform"),
+      platformId: z
+        .string()
+        .optional()
+        .describe("Platform ID (required for 'update' and 'delete')"),
+      name: z
+        .enum(["meta", "x", "google", "tiktok"])
+        .optional()
+        .describe("Platform name (required for 'create' and 'test')"),
+      displayName: z
+        .string()
+        .optional()
+        .describe("Display name for the platform (e.g. 'Meta広告')"),
+      config: z
+        .record(z.unknown())
+        .optional()
+        .describe(
+          "Platform config JSON. Meta: {pixel_id, access_token, test_event_code?}. X: {pixel_id, api_key, api_secret}. Google: {customer_id, conversion_action_id, oauth_token}. TikTok: {pixel_code, access_token}",
+        ),
+      isActive: z
+        .boolean()
+        .optional()
+        .describe("Enable/disable the platform (for 'update')"),
+      eventName: z
+        .string()
+        .optional()
+        .describe("Event name for test conversion (for 'test', e.g. 'Lead')"),
+      friendId: z
+        .string()
+        .optional()
+        .describe("Friend ID for test conversion (for 'test')"),
+    },
+    async ({ action, platformId, name, displayName, config, isActive, eventName, friendId }) => {
+      try {
+        const client = getClient();
+
+        switch (action) {
+          case "list": {
+            const platforms = await client.adPlatforms.list();
+            return {
+              content: [
+                {
+                  type: "text" as const,
+                  text: JSON.stringify(
+                    {
+                      success: true,
+                      count: platforms.length,
+                      platforms,
+                    },
+                    null,
+                    2,
+                  ),
+                },
+              ],
+            };
+          }
+
+          case "create": {
+            if (!name) throw new Error("name is required for create action");
+            if (!config)
+              throw new Error("config is required for create action");
+
+            const platform = await client.adPlatforms.create({
+              name,
+              displayName,
+              config,
+            });
+
+            return {
+              content: [
+                {
+                  type: "text" as const,
+                  text: JSON.stringify({ success: true, platform }, null, 2),
+                },
+              ],
+            };
+          }
+
+          case "update": {
+            if (!platformId)
+              throw new Error("platformId is required for update action");
+
+            const platform = await client.adPlatforms.update(platformId, {
+              name,
+              displayName,
+              config,
+              isActive,
+            });
+
+            return {
+              content: [
+                {
+                  type: "text" as const,
+                  text: JSON.stringify({ success: true, platform }, null, 2),
+                },
+              ],
+            };
+          }
+
+          case "delete": {
+            if (!platformId)
+              throw new Error("platformId is required for delete action");
+
+            await client.adPlatforms.delete(platformId);
+            return {
+              content: [
+                {
+                  type: "text" as const,
+                  text: JSON.stringify({
+                    success: true,
+                    message: `Platform ${platformId} deleted`,
+                  }),
+                },
+              ],
+            };
+          }
+
+          case "test": {
+            if (!name) throw new Error("name is required for test action");
+            if (!eventName)
+              throw new Error("eventName is required for test action");
+
+            const result = await client.adPlatforms.test(
+              name,
+              eventName,
+              friendId,
+            );
+
+            return {
+              content: [
+                {
+                  type: "text" as const,
+                  text: JSON.stringify({ success: true, ...result }, null, 2),
+                },
+              ],
+            };
+          }
+
+          default:
+            throw new Error(`Unknown action: ${action}`);
+        }
+      } catch (error) {
+        return {
+          content: [
+            {
+              type: "text" as const,
+              text: JSON.stringify(
+                { success: false, error: String(error) },
+                null,
+                2,
+              ),
+            },
+          ],
+          isError: true,
+        };
+      }
+    },
+  );
+}

package/src/tools/manage-staff.ts

@@ -0,0 +1,104 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { getClient } from "../client.js";
+
+export function registerManageStaff(server: McpServer): void {
+  server.tool(
+    "manage_staff",
+    "スタッフアカウントの追加・一覧・更新・削除・APIキー再生成。オーナー権限が必要です。",
+    {
+      action: z
+        .enum(["create", "list", "get", "update", "delete", "regenerate_key", "me"])
+        .describe("Action to perform"),
+      name: z.string().optional().describe("Staff name (for 'create' action)"),
+      email: z.string().nullable().optional().describe("Staff email (optional, null to clear)"),
+      role: z.enum(["admin", "staff"]).optional().describe("Staff role (for 'create'/'update')"),
+      staffId: z.string().optional().describe("Staff ID (for 'get','update','delete','regenerate_key')"),
+      isActive: z.boolean().optional().describe("Activate/deactivate (for 'update')"),
+    },
+    async ({ action, name, email, role, staffId, isActive }) => {
+      try {
+        const client = getClient();
+
+        if (action === "me") {
+          const profile = await client.staff.me();
+          return {
+            content: [{ type: "text" as const, text: JSON.stringify({ success: true, profile }, null, 2) }],
+          };
+        }
+
+        if (action === "list") {
+          const members = await client.staff.list();
+          return {
+            content: [{ type: "text" as const, text: JSON.stringify({ success: true, members }, null, 2) }],
+          };
+        }
+
+        if (action === "create") {
+          if (!name) throw new Error("name is required for create action");
+          if (!role) throw new Error("role is required for create action");
+          const member = await client.staff.create({ name, email, role });
+          return {
+            content: [{
+              type: "text" as const,
+              text: JSON.stringify({
+                success: true, member,
+                note: "APIキーは一度だけ表示されます。安全に保管してください。",
+              }, null, 2),
+            }],
+          };
+        }
+
+        if (action === "get") {
+          if (!staffId) throw new Error("staffId is required for get action");
+          const member = await client.staff.get(staffId);
+          return {
+            content: [{ type: "text" as const, text: JSON.stringify({ success: true, member }, null, 2) }],
+          };
+        }
+
+        if (action === "update") {
+          if (!staffId) throw new Error("staffId is required for update action");
+          const updates: Record<string, unknown> = {};
+          if (name !== undefined) updates.name = name;
+          if (email !== undefined) updates.email = email;
+          if (role !== undefined) updates.role = role;
+          if (isActive !== undefined) updates.isActive = isActive;
+          const member = await client.staff.update(staffId, updates);
+          return {
+            content: [{ type: "text" as const, text: JSON.stringify({ success: true, member }, null, 2) }],
+          };
+        }
+
+        if (action === "delete") {
+          if (!staffId) throw new Error("staffId is required for delete action");
+          await client.staff.delete(staffId);
+          return {
+            content: [{ type: "text" as const, text: JSON.stringify({ success: true, deleted: staffId }, null, 2) }],
+          };
+        }
+
+        if (action === "regenerate_key") {
+          if (!staffId) throw new Error("staffId is required for regenerate_key action");
+          const result = await client.staff.regenerateKey(staffId);
+          return {
+            content: [{
+              type: "text" as const,
+              text: JSON.stringify({
+                success: true, staffId, newApiKey: result.apiKey,
+                note: "新しいAPIキーは一度だけ表示されます。安全に保管してください。",
+              }, null, 2),
+            }],
+          };
+        }
+
+        throw new Error(`Unknown action: ${action}`);
+      } catch (error) {
+        return {
+          content: [{ type: "text" as const, text: JSON.stringify({ success: false, error: String(error) }, null, 2) }],
+          isError: true,
+        };
+      }
+    },
+  );
+}