# C\# MCP SDK

O SDK oficial C\# para o Model Context Protocol (MCP), mantido em colaboração com a Microsoft. Permite que desenvolvedores .NET construam facilmente servidores e clientes MCP, expondo ferramentas, recursos e prompts para agentes de IA como Claude, Cursor e Gemini.

Canonical URL: https://a2a-mcp.org/entry/csharp-mcp-sdk-pt

Language: pt

Category: Frameworks & SDKs

Updated: 2026-04-11

## Visão Geral

O **C# MCP SDK** (repositório: modelcontextprotocol/csharp-sdk) é o **SDK .NET oficial** para o Model Context Protocol, desenvolvido em colaboração com a Microsoft. Ele permite que desenvolvedores .NET implementem servidores e clientes MCP com APIs idiomáticas em C#, tornando simples conectar agentes de IA a aplicações .NET, fontes de dados corporativas, APIs internas e fluxos de trabalho personalizados.

Lançado na versão estável v1.0 em março de 2026 com suporte completo à especificação MCP de 2025.11.25, o SDK é Tier 1 no ecossistema MCP oficial e é a forma recomendada para equipes C#/.NET participarem do crescente cenário MCP.

## Principais Características

- **Suporte Completo à Especificação MCP**: Implementa o protocolo mais recente (2025-11-25) incluindo Tools, Resources, Prompts, Elicitation, Sampling e Tasks experimentais.
- **Três Pacotes NuGet**:
  - `ModelContextProtocol.Core` — Dependências mínimas para clientes e servidores de baixo nível.
  - `ModelContextProtocol` — Funcionalidade completa para a maioria dos casos de uso.
  - `ModelContextProtocol.AspNetCore` — Integração perfeita com ASP.NET Core para transporte HTTP/SSE.
- **Definição Fácil de Tools**: Decore métodos com atributos ou use APIs fluentes para expor funções C# como MCP Tools com geração automática de JSON Schema.
- **Autorização Integrada**: Suporte de primeira classe para OAuth 2.1, OpenID Connect discovery, PKCE e consentimento incremental de escopo.
- **Múltiplos Transportes**: stdio, HTTP, SSE e Streamable HTTP.
- **Integração Microsoft.Extensions.AI**: Interoperabilidade suave com Semantic Kernel e outras bibliotecas de IA .NET.
- **Pronto para Produção**: Observabilidade, logging, injeção de dependência, acesso a HttpContext e opções de compatibilidade AOT.
- **Excelente Documentação**: Documentação abrangente da API em csharp.sdk.modelcontextprotocol.io.

## Como Funciona

### Construindo um Servidor MCP (Exemplo Mínimo)
```csharp
using ModelContextProtocol;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddMcpServer()
    .WithHttpTransport()
    .WithTools<MyCustomTools>();

var app = builder.Build();
app.MapMcp();
app.Run();
```

Defina tools de forma simples:
```csharp
public class MyCustomTools
{
    [McpTool]
    public string GetWeather(string city) 
        => $"Ensolarado em {city}";
}
```

Agentes de IA (Claude Desktop, Cursor, etc.) podem então descobrir e chamar essas tools automaticamente.

## Casos de Uso

- **Integração de Dados Corporativos**: Exponha bancos de dados internos, sistemas CRM ou APIs de negócio para agentes de IA de forma segura.
- **Ferramentas .NET para Agentes**: Construa servidores MCP que permitam à IA controlar dotnet CLI, analisadores Roslyn, pacotes NuGet ou recursos do Azure.
- **Fluxos de Trabalho de IA Personalizados**: Conecte serviços .NET legados a aplicações modernas baseadas em agentes.
- **Aplicações Híbridas de IA**: Combine MCP com Semantic Kernel ou Microsoft.Extensions.AI para experiências ricas com agentes.
- **Ferramentas Internas de Desenvolvimento**: Crie ferramentas específicas da organização para geração de código, implantação ou monitoramento.

## Começando

1. Instale o pacote principal:
   ```bash
   dotnet add package ModelContextProtocol
   ```

2. Siga os guias rápidos oficiais no [repositório GitHub](https://github.com/modelcontextprotocol/csharp-sdk) ou na [Documentação do SDK](https://csharp.sdk.modelcontextprotocol.io/).

3. Explore exemplos ricos em [microsoft/mcp-dotnet-samples](https://github.com/microsoft/mcp-dotnet-samples).

O SDK funciona com aplicativos de console, ASP.NET Core, Azure Functions e mais. Suporte completo para implementações de servidor e cliente.

## Benefícios

O SDK MCP para C# traz o poder do Model Context Protocol para o ecossistema .NET com padrões familiares, tipagem forte, injeção de dependência e segurança de nível empresarial. Ele reduz a barreira para equipes .NET criarem servidores MCP de produção mantendo compatibilidade total com o ecossistema MCP mais amplo (Claude, Cursor, Gemini CLI, etc.).

Como um SDK oficial Tier 1 mantido com a Microsoft, ele recebe atualizações oportunas alinhadas com a especificação MCP em evolução e é amplamente usado tanto para ferramentas internas quanto para integrações públicas de IA.

**Links Oficiais**:
- GitHub: https://github.com/modelcontextprotocol/csharp-sdk
- Documentação: https://csharp.sdk.modelcontextprotocol.io/
- Anúncio no Blog .NET: https://devblogs.microsoft.com/dotnet/release-v10-of-the-official-mcp-csharp-sdk/

## Tags

- mcp
- csharp
- dotnet
- framework
- sdk
- agente-ia
- microsoft
- modelcontextprotocol
- ferramentas

## Sources

- [Project website](https://github.com/modelcontextprotocol/csharp-sdk)