@slorenzot/mcp-azure

Instructions

Implementation Reference

• src/index.ts:193-216 (handler)

  The handler function for 'ado_configure' that establishes the Azure DevOps connection.

  async ({ organization, project, pat }) => {
    const authHandler = azdev.getPersonalAccessTokenHandler(pat);
    connection = new azdev.WebApi(organization, authHandler);
    workItemTrackingApi = null;
    coreApiClient = null;
    currentProject = project;
    currentPat = pat;
    currentOrg = organization;
  
    // Verificar conexión
    try {
      const connData = await connection.connect();
      return {
        content: [
          {
            type: "text",
            text: `Conexión establecida exitosamente.\n- Organización: ${organization}\n- Proyecto: ${project}\n- Usuario autenticado: ${connData.authenticatedUser?.providerDisplayName || "N/A"}`,
          },
        ],
      };
    } catch (error: any) {
      connection = null;
      throw new Error(`Error al conectar: ${error.message}`);
    }

• src/index.ts:181-217 (registration)

  The tool registration for 'ado_configure' using server.tool.

  server.tool(
    "ado_configure",
    "Configura la conexión a Azure DevOps con token de acceso personal (PAT).",
    {
      organization: z
        .string()
        .describe("URL de la organización (ej: https://dev.azure.com/mi-org)"),
      project: z.string().describe("Nombre del proyecto"),
      pat: z
        .string()
        .describe("Token de acceso personal (PAT) de Azure DevOps"),
    },
    async ({ organization, project, pat }) => {
      const authHandler = azdev.getPersonalAccessTokenHandler(pat);
      connection = new azdev.WebApi(organization, authHandler);
      workItemTrackingApi = null;
      coreApiClient = null;
      currentProject = project;
      currentPat = pat;
      currentOrg = organization;
  
      // Verificar conexión
      try {
        const connData = await connection.connect();
        return {
          content: [
            {
              type: "text",
              text: `Conexión establecida exitosamente.\n- Organización: ${organization}\n- Proyecto: ${project}\n- Usuario autenticado: ${connData.authenticatedUser?.providerDisplayName || "N/A"}`,
            },
          ],
        };
      } catch (error: any) {
        connection = null;
        throw new Error(`Error al conectar: ${error.message}`);
      }
    }

• src/index.ts:184-192 (schema)

  The Zod schema definition for 'ado_configure' input parameters.

  {
    organization: z
      .string()
      .describe("URL de la organización (ej: https://dev.azure.com/mi-org)"),
    project: z.string().describe("Nombre del proyecto"),
    pat: z
      .string()
      .describe("Token de acceso personal (PAT) de Azure DevOps"),
  },