--- schema_version: "1" id: f1a320e97493757b603b86ef53ac817b5e2d924b88ea0393f2d12db6ee107466 title: gRPC Connector 1.0 collection: mulesoft version: current locale: en-us portal_url: https://docs.salesforce.com/mulesoft/current/en-us/grpc-connector/latest/index.md canonical_url: https://docs.mulesoft.com/grpc-connector/latest/ source_site: docs.mulesoft.com content_type: documentation content_hash: 52b79979df9b57ece3f962daa67db412b3584f8be1b6d25f6d0e40c93bc61d2a description: MuleSoft Documentation Site release: "1.0" latest: true --- --- product: gRPC Connector version: 1.0 is-latest-version: true --- # gRPC Connector 1.0 > For the full documentation index, see: https://docs.mulesoft.com/llms.txt Anypoint Connector for gRPC (gRPC Connector) enables you to connect to the gRPC API. gRPC Connector enables Mule applications to communicate with gRPC services, providing both client and server capabilities for high-performance, cross-platform RPC communication. For information about compatibility and fixed issues, refer to the gRPC Connector Release Notes. ## Before You Begin To use this connector, you must be familiar with: - The gRPC Connector’s API - Anypoint Connectors - Mule runtime engine (Mule) - Elements and global elements in a Mule flow - How to create a Mule app using Anypoint Code Builder or Anypoint Studio Before creating an app, you must have: - Credentials to access the gRPC target resource - Anypoint Platform - The latest versions of Anypoint Code Builder or Anypoint Studio ## Supported gRPC Patterns This connector supports all four gRPC communication patterns.
PatternDescription

Unary

Single request, single response

Server Streaming

Single request, multiple responses streamed from server

Client Streaming

Multiple requests from client, single response

Bidirectional Streaming

Multiple requests and responses streamed in both directions

## Key Capabilities - Protocol Buffer Support Native support for protobuf descriptor files (`.desc`) - Dynamic Metadata Resolution Automatic type resolution based on IDL definitions - Connection Management Managed channels with connection pooling and validation - Conversation Management Support for stateful streaming conversations - Async Operations Non-blocking asynchronous operation execution - TLS Support Configurable TLS/SSL for secure connections - Custom Headers Support for default headers on connections - Custom Status Codes Server sources can return a specific gRPC status code and description to the client ## Architecture ### Component Diagram ![A flowchart illustrating the architecture of a gRPC connector within a Mule application as it communicates with a gRPC server](/mulesoft/current/en-us/grpc-connector/latest/_images/grpc-connector-architecture.png) ### Conversation Management The connector maintains stateful conversations for streaming operations: - Server Conversations Maps `conversationId` to `ServerConversation` containing shared FrameWrapperQueue for multiple streaming requests - Client Conversations Maps conversationId to ClientConversation with request observer and response future - Bidirectional Conversations Maps `conversationId` to `BidiConversation` for bidirectional streaming with request or response observers ## Next Step After you complete the prerequisites, you’re ready to create an app and configure the connector using [Anypoint Studio](https://docs.mulesoft.com/grpc-connector/latest/grpc-connector-studio) or [Anypoint Code Builder](https://docs.mulesoft.com/grpc-connector/latest/grpc-connector-acb). ## See Also - [Introduction to Anypoint Connectors](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [Use Exchange to Discover Connectors, Templates, and Examples](https://docs.mulesoft.com/connectors/introduction/intro-use-exchange) - [gRPC Connector Reference](https://docs.mulesoft.com/grpc-connector/latest/grpc-connector-reference) - [Salesforce Help](https://help.salesforce.com)