@x0333/bitrix24-mcp-server 2.3.1 → 2.3.3

package/index.js

@@ -35,14 +35,20 @@ function bitrixPortalUrlFromBase(base) {
 }
 
 const B24_PORTAL_URL = bitrixPortalUrlFromBase(B24_BASE);
-const mcpInstructions = B24_PORTAL_URL
-  ? `Bitrix24 address: ${B24_PORTAL_URL}`
-  : "Bitrix24 address: take scheme and host from B24_BASE (the part before /rest/ in the webhook URL).";
+if (!B24_PORTAL_URL) {
+  console.error("Error: B24_BASE must be a valid absolute URL with a host (e.g., https://domain.bitrix24.ru/rest/1/abcde/).");
+  process.exit(1);
+}
+
+const taskViewUrlPrefix = `${B24_PORTAL_URL}/company/personal/user/0/tasks/task/view/`;
+const taskPortalLinkHowto =
+  `When the user needs a link to a task (or to paste one), use ${taskViewUrlPrefix}<task-id>/ — substitute only <task-id> with the numeric task ID from the API. Example: ${taskViewUrlPrefix}9483/`;
+const mcpInstructions = `Bitrix24 address: ${B24_PORTAL_URL}. ${taskPortalLinkHowto}`;
 
 const server = new Server(
   {
     name: "bitrix24-mcp-server",
-    version: "2.3.0",
+    version: "2.3.3",
   },
   {
     capabilities: {
@@ -140,7 +146,10 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: "get_task",
-        description: "Retrieve task details by ID from Bitrix24",
+        description:
+          "Retrieve task details by ID from Bitrix24. " +
+          taskPortalLinkHowto +
+          " The tool response JSON includes agent_instructions with the same rule plus a direct link for the requested task id.",
         inputSchema: {
           type: "object",
           properties: {
@@ -255,9 +264,15 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       }
 
       case "get_task": {
+        const taskId = Number(args.id);
         const body = { taskId: args.id, select: args.select || ["*"] };
         const data = await callBitrix("tasks.task.get", body);
-        return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+        throwIfBitrixError(data, "tasks.task.get");
+        const payload = {
+          ...data,
+          agent_instructions: `${taskPortalLinkHowto} For this task: ${taskViewUrlPrefix}${taskId}/`,
+        };
+        return { content: [{ type: "text", text: JSON.stringify(payload, null, 2) }] };
       }
 
       case "search_tasks": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@x0333/bitrix24-mcp-server",
-  "version": "2.3.1",
+  "version": "2.3.3",
   "description": "Bitrix24 MCP Server for AI Agent Integration.",
   "main": "index.js",
   "bin": {