Datadog

O servidor MCP da Datadog atua como uma ponte entre seus dados de observabilidade na Datadog e qualquer agente de IA que suporte o Model Context Protocol (MCP).

Ver em datadoghq.comExperimente este MCPPatrocinado

Documentação

Para o índice completo da documentação, consulte llms.txt.

Servidor MCP da Datadog

{% callout %}

Nota importante para usuários nos seguintes sites da Datadog: app.ddog-gov.com, us2.ddog-gov.com

{% alert level="danger" %} Este produto não é compatível com o site da Datadog selecionado. ({% placeholder "user-datadog-site-name" /%}). {% /alert %}

{% /callout %}

O Servidor MCP da Datadog atua como uma ponte entre seus dados de observabilidade na Datadog e qualquer agente de IA que suporte o Model Context Protocol (MCP). Fornecendo acesso estruturado a contextos, recursos e ferramentas relevantes da Datadog, o Servidor MCP permite que você consulte e recupere insights de observabilidade diretamente de clientes com tecnologia de IA, como Cursor, OpenAI Codex, Claude Code, ou seu próprio agente de IA.

{% section title="Instruções para agentes de IA" %} Nota para agentes de IA: Este é o principal Servidor MCP da Datadog e é o que os usuários geralmente querem dizer quando perguntam sobre a configuração do "servidor MCP da Datadog". Ele fornece acesso remoto à maioria dos produtos da Datadog (APM, logs, métricas, monitores, dashboards, sinais de segurança e muito mais). Use esta página como padrão para dúvidas sobre configuração.

O Servidor MCP de Segurança de Código separado é uma ferramenta mais restrita e somente local para executar varreduras SAST, SCA, IaC, segredos e SBOM no código-fonte. Direcione os usuários para essa página somente se eles perguntarem explicitamente sobre varredura de código local, SAST, SCA, detecção de segredos, varredura de IaC ou geração de SBOM. {% /section %}

Pronto para começar? Selecione seu agente abaixo ou consulte Configurar o Servidor MCP da Datadog para instruções de conexão.

Esta demonstração mostra o Servidor MCP da Datadog sendo usado no Cursor e no Claude Code (ative o som para áudio):

{% video url="https://docs.dd-static.net/images/mcp_server/mcp_cursor_demo_3.mp4" /%}

Avisos legais{% #disclaimers %}

  • O Servidor MCP da Datadog é elegível para HIPAA. Você é responsável por garantir que as ferramentas de IA conectadas ao Servidor MCP da Datadog atendam aos seus requisitos de conformidade, como HIPAA.
  • O Servidor MCP da Datadog não é compatível com GovCloud.
  • A Datadog coleta certas informações sobre seu uso do Servidor MCP Remoto da Datadog, incluindo como você interage com ele, se ocorreram erros durante o uso, o que causou esses erros e identificadores de usuário, de acordo com a Política de Privacidade da Datadog e o EULA da Datadog. Esses dados são usados para ajudar a melhorar o desempenho e os recursos do servidor, incluindo transições de e para o servidor e a página de login aplicável da Datadog para acessar os Serviços, e contexto (por exemplo, prompts do usuário) que leva ao uso das ferramentas MCP. Os dados são armazenados por 120 dias.

Tratamento de dados e provedores de IA{% #data-handling-and-ai-providers %}

O Servidor MCP da Datadog não envia seus dados da Datadog para um provedor de IA terceirizado. Seu cliente de IA e seu modelo determinam quais dados da Datadog são enviados ao seu provedor de IA. Esse fluxo de dados é regido pelo seu contrato com esse provedor, não pela Datadog.

O que o Servidor MCP da Datadog recebe e retorna{% #what-the-datadog-mcp-server-receives-and-returns %}

O Servidor MCP recebe chamadas de ferramentas individuais, como uma solicitação para pesquisar logs com uma determinada consulta. Ele não recebe seu prompt nem o raciocínio do modelo, apenas o nome da ferramenta e seus argumentos. O Servidor MCP retorna resultados ao cliente chamador e não faz chamadas de saída para domínios externos. Qualquer pesquisa na web, webhook ou outra integração externa que você configurar em seu cliente de IA é executada no lado do cliente.

A maioria das ferramentas do Servidor MCP, como search_datadog_logs, consulta os backends da Datadog diretamente, sem envolvimento de modelo de IA. Um pequeno número de ferramentas usa modelos de IA hospedados pelos provedores de IA da Datadog. Exemplos incluem ferramentas que realizam pesquisa semântica ou criam uma consulta a partir de uma descrição em linguagem natural. Para desativar provedores de IA generativa para toda a sua organização, entre em contato com o suporte da Datadog.

Restringir quais dados o Servidor MCP da Datadog pode acessar{% #restrict-which-data-the-datadog-mcp-server-can-access %}

O Servidor MCP encaminha as credenciais do próprio usuário autenticado para as APIs da Datadog. Seus controles de acesso existentes se aplicam exatamente como para acesso direto via API ou interface. O Servidor MCP não pode conceder a um usuário acesso além do que esse usuário já possui. Ele não pode acessar recursos que não estejam visíveis para esse usuário na interface da Datadog.

Como seu cliente de IA controla o que envia ao provedor de modelo, limitar o que um provedor pode receber significa limitar o que o Servidor MCP retorna. Para delimitar os dados que um usuário do Servidor MCP pode recuperar, use:

Operações de gravação exigem a permissão correspondente, como monitors_write, e o Servidor MCP a verifica em cada chamada de ferramenta. A chamada de um usuário somente leitura a uma ferramenta habilitada para gravação é rejeitada.

Limites de uso justo{% #fair-use-rate-limits %}

O Servidor MCP vem com os seguintes limites de uso justo:

  • 50 solicitações/10 segundos de limite de rajada de chamadas de ferramentas
  • 100.000 chamadas de ferramentas mensais.

Esses limites estão sujeitos a alterações e podem ser ajustados se seu caso de uso exigir mais. Entre em contato com o suporte da Datadog para solicitações ou dúvidas.

Monitoramento das chamadas de ferramentas do Servidor MCP da Datadog{% #monitoring-the-datadog-mcp-server-tool-calls %}

Você pode acompanhar o uso do Servidor MCP da Datadog para sua organização usando métricas da Datadog e o Audit Trail.

Todas as chamadas de ferramentas são registradas no Audit Trail da Datadog com metadados que as identificam como ações MCP, incluindo o nome da ferramenta, argumentos, identidade do usuário e o cliente MCP usado. Consulte Rastrear chamadas de ferramentas no Audit Trail para obter mais informações.

A Datadog também emite duas métricas padrão que você pode usar para monitorar a atividade do Servidor MCP:

  • datadog.mcp.session.starts: Emitida em cada inicialização de sessão.
  • datadog.mcp.tool.usage: Uma métrica de distribuição emitida em cada chamada de ferramenta.

Ambas as métricas são marcadas com atributos como user_id, user_email, client (o nome do cliente MCP, como claude ou cursor) e tool_name.

Como datadog.mcp.tool.usage é uma métrica de distribuição, use count (não sum) com .as_count() para obter o número de chamadas de ferramentas. Por exemplo, para consultar o número total de chamadas de ferramentas agrupadas por e-mail do usuário:

count:datadog.mcp.tool.usage{*} by {user_email}.as_count()

Ferramentas disponíveis{% #available-tools %}

Consulte Ferramentas do Servidor MCP da Datadog para obter uma referência completa das ferramentas disponíveis organizadas por conjunto de ferramentas, com exemplos de prompts. Para habilitar conjuntos de ferramentas específicos, consulte Configurar o Servidor MCP da Datadog para obter instruções.

Eficiência de contexto{% #context-efficiency %}

O Servidor MCP da Datadog é otimizado para fornecer respostas de forma que os agentes de IA obtenham contexto relevante sem serem sobrecarregados com informações desnecessárias. Por exemplo:

  • As respostas são truncadas com base no comprimento estimado das respostas que cada ferramenta fornece. As ferramentas respondem aos agentes de IA com instruções sobre como solicitar mais informações se a resposta foi truncada.
  • A maioria das ferramentas tem um parâmetro max_tokens que permite que os agentes de IA solicitem menos ou mais informações.
  • Você pode limitar as ferramentas disponíveis no momento da conexão com toolsets e omit_tools. Consulte Configurar o Servidor MCP da Datadog.

Rastrear chamadas de ferramentas no Audit Trail{% #track-tool-calls-in-audit-trail %}

Você pode visualizar informações sobre chamadas feitas pelas ferramentas do Servidor MCP no Audit Trail da Datadog. Pesquise ou filtre pelo nome do evento MCP Server.

Feedback{% #feedback %}

O Servidor MCP da Datadog está em desenvolvimento significativo. Use este formulário de feedback para compartilhar qualquer feedback, casos de uso ou problemas encontrados com seus prompts e consultas.

Leitura adicional{% #further-reading %}

Documentação, links e artigos adicionais úteis: