MCP Dynamics CRM Server

Instructions

Implementation Reference

• src/tools/solutions/index.ts:295-319 (handler)

  The handler for the 'dynamics_import_solution' tool. It triggers the 'ImportSolution' action via the Dataverse client.

  // 7. Import Solution
  server.tool(
    "dynamics_import_solution",
    "Importa uma solução para o Dynamics CRM",
    ImportSolutionSchema.shape,
    async (params: z.infer<typeof ImportSolutionSchema>) => {
      const importJobId = params.importJobId || crypto.randomUUID();
  
      await client.executeAction("ImportSolution", {
        CustomizationFile: params.customizationFile,
        OverwriteUnmanagedCustomizations: params.overwriteUnmanagedCustomizations,
        PublishWorkflows: params.publishWorkflows,
        ImportJobId: importJobId,
      });
  
      return {
        content: [
          {
            type: "text" as const,
            text: `Importação da solução iniciada!\nImport Job ID: ${importJobId}\n\nUse dynamics_get_import_job_status para acompanhar o progresso.`,
          },
        ],
      };
    }
  );

• src/tools/solutions/index.ts:55-60 (schema)

  Input validation schema for 'dynamics_import_solution'.

  export const ImportSolutionSchema = z.object({
    customizationFile: z.string().describe("Conteúdo do arquivo ZIP da solução em Base64"),
    overwriteUnmanagedCustomizations: z.boolean().default(true),
    publishWorkflows: z.boolean().default(true),
    importJobId: z.string().optional().describe("ID do job de importação (gerado automaticamente se não fornecido)"),
  });

• src/tools/solutions/index.ts:297-297 (registration)

  Registration of the 'dynamics_import_solution' tool.

  "dynamics_import_solution",