Dooray MCP Server

Instructions

Implementation Reference

• src/tools/projects/update-task-comment.ts:25-46 (handler)

  The main handler function that executes the tool logic by calling the projects API to update the task comment and returns a success message or formatted error.

  export async function updateTaskCommentHandler(args: UpdateTaskCommentInput) {
    try {
      await projectsApi.updateTaskComment({
        projectId: args.projectId,
        taskId: args.taskId,
        commentId: args.commentId,
        body: args.body,
        attachFileIds: args.attachFileIds,
      });
  
      return {
        content: [
          {
            type: 'text',
            text: `Successfully updated comment ${args.commentId}`
          }
        ],
      };
    } catch (error) {
      return formatError(error);
    }
  }

• src/tools/projects/update-task-comment.ts:10-21 (schema)

  Zod schema definitions for input validation, including nested bodySchema and the main updateTaskCommentSchema used for tool parameter validation.

  const bodySchema = z.object({
    content: z.string().describe('Comment content'),
    mimeType: z.enum(['text/x-markdown', 'text/html']).describe('Content format (use text/x-markdown for most cases)'),
  });
  
  export const updateTaskCommentSchema = z.object({
    projectId: z.string().describe('Project ID where the task belongs'),
    taskId: z.string().describe('Task ID where the comment exists'),
    commentId: z.string().describe('Comment ID to update'),
    body: bodySchema.optional().describe('New comment content'),
    attachFileIds: z.array(z.string()).optional().describe('Array of file IDs to attach (optional)'),
  });

• src/index.ts:56-56 (registration)

  Registers the updateTaskCommentHandler and updateTaskCommentSchema in the central toolRegistry map, which is used by the MCP server to dispatch tool calls.

  'update-task-comment': { handler: updateTaskCommentHandler, schema: updateTaskCommentSchema },

• src/index.ts:79-79 (registration)

  Includes the updateTaskCommentTool definition in the tools array, which is returned in response to list_tools requests.

  updateTaskCommentTool,

• src/tools/projects/update-task-comment.ts:48-145 (helper)

  Tool metadata object containing name, detailed description, and JSON inputSchema for the update-task-comment tool, used in list_tools responses.

  export const updateTaskCommentTool = {
    name: 'update-task-comment',
    description: `Update an existing comment (댓글) on a Dooray task.
  
  This tool modifies the content or attachments of an existing task comment.
  
  **IMPORTANT LIMITATION**: Comments created from incoming emails CANNOT be modified. Only regular comments can be updated.
  
  **URL Pattern Recognition**:
  When given a Dooray task URL like "https://nhnent.dooray.com/task/PROJECT_ID/TASK_ID" or "https://nhnent.dooray.com/project/tasks/TASK_ID":
  - Extract the first numeric ID after "/task/" as projectId (if present)
  - Extract the second numeric ID (or the ID after "/tasks/") as taskId
  - Use get-task-comment-list to find the comment ID you want to update
  
  **REQUIRED**: projectId, taskId, and commentId are all required.
  
  **Optional Parameters**: You can provide either body, attachFileIds, or both. If you only want to update the text, just provide body. If you only want to update attachments, just provide attachFileIds.
  
  **File Attachments**:
  - To attach files, first upload them using the file upload API
  - Then provide the returned file IDs in the attachFileIds parameter
  - See: https://helpdesk.dooray.com/share/pages/9wWo-xwiR66BO5LGshgVTg/2939987647631384419
  
  **Workflow**:
  1. Use get-task-comment-list to find the comment you want to update and get its ID
  2. Call update-task-comment with the comment ID and new content/attachments
  3. The comment will be modified immediately
  
  **Content Format**:
  - Use "text/x-markdown" for markdown formatting (recommended)
  - Use "text/html" for rich HTML content
  - Body format: {"mimeType": "text/x-markdown", "content": "..."}
  
  **Examples**:
  - Update comment text only: {
      "projectId": "123456",
      "taskId": "789012",
      "commentId": "4219415732999317024",
      "body": {
        "mimeType": "text/x-markdown",
        "content": "## Updated Comment\\n\\nThis comment has been revised"
      }
    }
  
  - Update with new attachments: {
      "projectId": "123456",
      "taskId": "789012",
      "commentId": "4219415732999317024",
      "body": {
        "mimeType": "text/x-markdown",
        "content": "See updated files"
      },
      "attachFileIds": ["file123", "file456"]
    }
  
  Returns: Success message upon completion.`,
    inputSchema: {
      type: 'object',
      properties: {
        projectId: {
          type: 'string',
          description: 'Project ID where the task belongs',
        },
        taskId: {
          type: 'string',
          description: 'Task ID where the comment exists',
        },
        commentId: {
          type: 'string',
          description: 'Comment ID to update',
        },
        body: {
          type: 'object',
          properties: {
            content: {
              type: 'string',
              description: 'Comment content',
            },
            mimeType: {
              type: 'string',
              enum: ['text/x-markdown', 'text/html'],
              description: 'Content format (use text/x-markdown for most cases)',
            },
          },
          required: ['content', 'mimeType'],
          description: 'New comment content',
        },
        attachFileIds: {
          type: 'array',
          items: {
            type: 'string',
          },
          description: 'Array of file IDs to attach (optional)',
        },
      },
      required: ['projectId', 'taskId', 'commentId'],
    },
  };