MCP Reference: chatmcp.googleapis.com

모델 컨텍스트 프로토콜 (MCP) 서버는 대규모 언어 모델 (LLM) 또는 AI 애플리케이션에 컨텍스트, 데이터 또는 기능을 제공하는 외부 서비스 간의 프록시 역할을 합니다. MCP 서버는 AI 애플리케이션을 데이터베이스 및 웹 서비스와 같은 외부 시스템에 연결하여 응답을 AI 애플리케이션이 이해할 수 있는 형식으로 변환합니다.

MCP 도구

MCP 도구는 MCP 서버가 LLM 또는 AI 애플리케이션에 노출하여 실제 세계에서 작업을 실행하는 함수 또는 실행 가능한 기능입니다.

chatmcp.googleapis.com MCP 서버에는 다음과 같은 도구가 있습니다.

MCP 도구
list_messages 지정된 Google Chat 대화 (스페이스, 채팅 메시지 (DM) 또는 그룹 채팅 메시지)에서 메시지를 가져옵니다. 스레드, 시간 범위, 메시지 수별로 필터링할 수 있습니다. 또한 더 많은 컨텍스트를 허용하기 위해 메시지의 다음 페이지를 가져올 수 있습니다. 비공개 메시지 (단일 사용자에게만 표시되는 메시지)는 필터링됩니다.
search_conversations

표시 이름으로 Google Chat 대화를 검색합니다.

참여자만 제공된 경우 이 도구는 지정된 참여자와 호출 사용자를 포함하는 1:1 채팅 메시지 (참여자가 한 명 제공된 경우) 또는 그룹 채팅 (참여자가 여러 명 제공된 경우)을 찾습니다.

쿼리만 제공된 경우 이 도구는 쿼리가 대화의 표시 이름의 대소문자를 구분하지 않는 하위 문자열인 대화를 검색합니다.

참여자와 쿼리가 모두 제공된 경우 이 도구는 참여자별로 대화를 찾은 다음 표시 이름으로 필터링합니다.

참여자도 쿼리도 제공되지 않은 경우 이 도구는 호출 사용자가 회원으로 속한 모든 대화를 나열합니다.

이 도구는 호출 사용자가 회원으로 속한 대화만 나열합니다.

중요: '대화' 목록이 비어 있다고 해서 전반적으로 결과가 더 이상 없다는 의미는 아닙니다. 'next_page_token'이 있으면 더 많은 페이지를 가져올 수 있습니다. 목록이 비어 있지만 'next_page_token'이 있는 경우 사용자에게 검색을 계속할지 물어보세요.

MCP 도구 사양 가져오기

MCP 서버의 모든 도구에 대한 MCP 도구 사양을 가져오려면 tools/list 메서드를 사용하세요. 다음 예시에서는 curl을 사용하여 MCP 서버 내에서 현재 사용할 수 있는 모든 도구와 사양을 나열하는 방법을 보여줍니다.

curl 요청
curl --location 'https://chatmcp.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'