# AgentCore 게이트웨이에서 리소스 읽기 특정 리소스를 읽으려면 게이트웨이의 MCP 엔드포인트에 POST 요청을 하고를 요청 본문의 메서드 및 리소스의 URI`resources/read`로 지정합니다. ``` POST /mcp HTTP/1.1 Host: ${GatewayEndpoint} Content-Type: application/json Authorization: ${Authorization header} ${RequestBody} ``` 다음 값을 교체합니다. + `${GatewayEndpoint}` - [CreateGateway](https://docs.aws.amazon.com/bedrock-agentcore-control/latest/APIReference/API_CreateGateway.html) API의 응답에 제공된 게이트웨이의 URL입니다. + `${Authorization header}` - [인바운드 권한 부여를 설정할 때 자격 증명 공급자의 권한 부여](gateway-inbound-auth.md) 자격 증명입니다. + `${RequestBody}` - [모델 컨텍스트 프로토콜(MCP)](https://modelcontextprotocol.io/docs/getting-started/intro)의 [리소스 읽기](https://modelcontextprotocol.io/specification/2025-06-18/server/resources#reading-resources)에 지정된 요청 본문의 JSON 페이로드입니다. 를 `resources/read`로 `method` 포함하고 리소스`uri`의를 포함합니다. 응답은 각 항목에 `uri`, `mimeType`및 `text` (텍스트 콘텐츠의 경우) 또는 `blob` (base64 인코딩 바이너리 콘텐츠)가 포함된 `contents` 배열을 반환합니다. **참고** `resources/read` 작업은 요청을 다운스트림 MCP 서버에 라이브로 프록시합니다. 리소스 URI는에서 반환되는 원시 URI입니다`resources/list`(대상 접두사 없음). **참고** 여러 대상이 동일한 리소스 URI를 노출하면 게이트웨이는 가장 낮은 `resourcePriority` 값을 가진 대상으로 요청을 라우팅합니다. **중요** `uri` 파라미터는 삭제 없이 다운스트림 MCP 서버 대상으로 전달됩니다. 사용자가 제공한 리소스 URI에는 SSRF 공격용 악성 URL 엔드포인트가 포함되거나 로컬 파일 시스템 경로(예: `file:///etc/passwd`)를 읽으려고 시도할 수 있습니다. 를 호출하기 전에 예상 URIs 체계 및 패턴의 허용 목록에 대해 리소스 URI를 검증합니다`resources/read`. 신뢰할 수 있는 MCP 서버 대상`resources/list`에서가 반환한 URIs만 사용합니다. ## 리소스를 읽기 위한 코드 샘플 게이트웨이에서 리소스를 읽는 예를 보려면 다음 방법 중 하나를 선택합니다. **Example** 1. 다음 curl 요청은 ID가 인 게이트웨이를 `config://app-settings` 통해 URI가 인 리소스를 읽는 요청의 예를 보여줍니다`mygateway-abcdefghij`. ``` curl -X POST \ https://mygateway-abcdefghij.gateway.bedrock-agentcore.us-west-2.amazonaws.com/mcp \ -H "Content-Type: application/json" \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \ -d '{ "jsonrpc": "2.0", "id": "read-resource-request", "method": "resources/read", "params": { "uri": "config://app-settings" } }' ``` 1. ``` import requests import json def read_resource(gateway_url, access_token, resource_uri): headers = { "Content-Type": "application/json", "Authorization": f"Bearer {access_token}" } payload = { "jsonrpc": "2.0", "id": "read-resource-request", "method": "resources/read", "params": { "uri": resource_uri } } response = requests.post(gateway_url, headers=headers, json=payload) return response.json() # Example usage gateway_url = "https://${GatewayEndpoint}/mcp" # Replace with your actual gateway endpoint access_token = "${AccessToken}" # Replace with your actual access token result = read_resource( gateway_url, access_token, "config://app-settings" # Replace with the resource URI from resources/list ) print(json.dumps(result, indent=2)) ``` 1. ``` from mcp import ClientSession from mcp.client.streamable_http import streamablehttp_client from pydantic import AnyUrl import asyncio async def execute_mcp( url, token, resource_uri, headers=None ): default_headers = { "Authorization": f"Bearer {token}" } headers = {**default_headers, **(headers or {})} async with streamablehttp_client( url=url, headers=headers, ) as ( read_stream, write_stream, callA, ): async with ClientSession(read_stream, write_stream) as session: # 1. Perform initialization handshake print("Initializing MCP...") _init_response = await session.initialize() print(f"MCP Server Initialize successful! - {_init_response}") # 2. Read specific resource print(f"Reading resource: {resource_uri}") resource_response = await session.read_resource(uri=AnyUrl(resource_uri)) for content in resource_response.contents: print(f"URI: {content.uri}, MIME: {content.mimeType}") if hasattr(content, 'text') and content.text: print(f"Text: {content.text}") elif hasattr(content, 'blob') and content.blob: print(f"Blob (base64): {content.blob[:100]}...") return resource_response async def main(): url = "https://${GatewayEndpoint}/mcp" token = "your_bearer_token_here" resource_uri = "config://app-settings" await execute_mcp( url=url, token=token, resource_uri=resource_uri ) if __name__ == "__main__": asyncio.run(main()) ``` 1. 참고: Strands SDK 리소스 지원은 다를 수 있습니다. 가장 안정적인 `resources/read` 구현을 위해 위의 MCP 클라이언트 접근 방식을 사용합니다. ``` from strands.tools.mcp.mcp_client import MCPClient from mcp.client.streamable_http import streamablehttp_client def create_streamable_http_transport(mcp_url: str, access_token: str): return streamablehttp_client(mcp_url, headers={"Authorization": f"Bearer {access_token}"}) def run_agent(mcp_url: str, access_token: str): mcp_client = MCPClient(lambda: create_streamable_http_transport(mcp_url, access_token)) with mcp_client: result = mcp_client.read_resource_sync(uri="config://app-settings") print(result) run_agent(, ) ``` 1. 참고: LangGraph MCP 어댑터 리소스 지원은 다를 수 있습니다. 가장 안정적인 `resources/read` 구현을 위해 위의 MCP 클라이언트 접근 방식을 사용합니다. ``` import asyncio from mcp import ClientSession from mcp.client.streamable_http import streamablehttp_client from pydantic import AnyUrl async def read_resource(url, token, resource_uri): headers = {"Authorization": f"Bearer {token}"} async with streamablehttp_client(url=url, headers=headers) as ( read_stream, write_stream, callA ): async with ClientSession(read_stream, write_stream) as session: await session.initialize() response = await session.read_resource(uri=AnyUrl(resource_uri)) for content in response.contents: if hasattr(content, 'text') and content.text: print(f"{content.uri}: {content.text}") elif hasattr(content, 'blob') and content.blob: print(f"{content.uri}: ") asyncio.run(read_resource( "https://${GatewayEndpoint}/mcp", "${AccessToken}", "config://app-settings" )) ``` ## 오류 `resources/read` 작업은 다음과 같은 유형의 오류를 반환할 수 있습니다. + HTTP 상태 코드의 일부로 반환되는 오류: **AuthenticationError** 잘못된 인증 자격 증명으로 인해 요청이 실패했습니다. **HTTP 상태 코드**: 401 **AuthorizationError** 호출자에게 리소스를 읽을 수 있는 권한이 없습니다. **HTTP 상태 코드**: 403 **ResourceNotFoundError** 지정된 리소스 URI가 존재하지 않거나 대상에 의해 노출되지 않습니다. **HTTP 상태 코드**: 404 **ValidationError** 제공된 URI의 형식이 잘못되었거나 누락되었습니다. **HTTP 상태 코드**: 400 **InternalServerError** 내부 서버 오류가 발생했습니다. **HTTP 상태 코드**: 500 + MCP 오류. 이러한 유형의 오류에 대한 자세한 내용은 [모델 컨텍스트 프로토콜(MCP)](https://modelcontextprotocol.io/docs/getting-started/intro) 설명서의 [리소스를](https://modelcontextprotocol.io/specification/2025-06-18/server/resources) 참조하세요.