MCP Dynamics CRM Server

Instructions

Implementation Reference

• src/tools/schema/index.ts:443-478 (handler)

  The handler function for dynamics_update_column that processes parameters and executes a patch request to the Dynamics API.

  server.tool(
    "dynamics_update_column",
    "Atualiza propriedades de uma coluna existente",
    UpdateColumnSchema.shape,
    async (params: z.infer<typeof UpdateColumnSchema>) => {
      const updateData: Record<string, unknown> = {};
      if (params.displayName) {
        updateData.DisplayName = {
          "@odata.type": "Microsoft.Dynamics.CRM.Label",
          LocalizedLabels: [{ "@odata.type": "Microsoft.Dynamics.CRM.LocalizedLabel", Label: params.displayName, LanguageCode: 1046 }],
        };
      }
      if (params.description) {
        updateData.Description = {
          "@odata.type": "Microsoft.Dynamics.CRM.Label",
          LocalizedLabels: [{ "@odata.type": "Microsoft.Dynamics.CRM.LocalizedLabel", Label: params.description, LanguageCode: 1046 }],
        };
      }
      if (params.requiredLevel) {
        updateData.RequiredLevel = { Value: params.requiredLevel };
      }
      if (params.maxLength !== undefined) {
        updateData.MaxLength = params.maxLength;
      }
  
      await client.patch(
        `EntityDefinitions(LogicalName='${params.entityLogicalName}')/Attributes(LogicalName='${params.attributeLogicalName}')`,
        updateData
      );
  
      return {
        content: [
          {
            type: "text" as const,
            text: `Coluna ${params.attributeLogicalName} atualizada com sucesso!`,
          },

• src/tools/schema/index.ts:81-88 (schema)

  The Zod schema definition (UpdateColumnSchema) for the input validation of the dynamics_update_column tool.

  export const UpdateColumnSchema = z.object({
    entityLogicalName: z.string().describe("Nome lógico da entidade"),
    attributeLogicalName: z.string().describe("Nome lógico do atributo"),
    displayName: z.string().optional(),
    description: z.string().optional(),
    requiredLevel: z.enum(["None", "SystemRequired", "ApplicationRequired"]).optional(),
    maxLength: z.number().optional(),
  });