ACP로 딥 에이전트를 코드 에디터에 연결하기

ACP로 딥 에이전트를 코드 에디터에 연결하기

ACP(Agent Client Protocol)는 코딩 에이전트와 코드 에디터/IDE 사이의 통신을 표준화한 프로토콜이에요. ACP 호환 클라이언트라면 어디서든 내가 만든 딥 에이전트를 그대로 쓸 수 있고, 에디터가 프로젝트 컨텍스트를 넘겨주고 풍부한 업데이트를 받아오는 구조죠. ACP는 '에이전트-에디터 통합'을 위해 설계된 프로토콜이에요. 만약 에이전트가 외부 서버에 호스팅된 도구를 호출하게 만들고 싶다면 Model Context Protocol(MCP) 쪽을 보시면 됩니다.

출처: 공식문서

시작하기 (Quickstart)

먼저 ACP 통합 패키지를 설치합니다. 그다음 딥 에이전트를 ACP 위로 노출시켜요. 그러면 ACP 서버가 stdio 모드로 시작되는데, stdin으로 요청을 읽고 stdout으로 응답을 쓰는 방식이죠. 실제로는 보통 ACP 클라이언트(예: 에디터)가 실행하는 커맨드로 이걸 띄우고, 클라이언트와 서버가 stdio로 통신해요.

import asyncio
from acp import run_agent
from deepagents import create_deep_agent
from langgraph.checkpoint.memory import MemorySaver
from deepagents_acp.server import AgentServerACP

async def main() -> None:
    agent = create_deep_agent(
        model="google_genai:gemini-3.6-flash",
        # You can customize your deep agent here: set a custom prompt,
        # add your own tools, attach middleware, or compose subagents.
        system_prompt="You are a helpful coding assistant",
        checkpointer=MemorySaver(),
    )
    server = AgentServerACP(agent)
    await run_agent(server)

if __name__ == "__main__":
    asyncio.run(main())

여기서 create_deep_agent로 에이전트를 만들 때 모델·시스템 프롬프트·체크포인터를 원하는 대로 바꿔줄 수 있어요. 특히 AgentServerACP가 바로 그 에이전트를 ACP 서버로 감싸주는 핵심 부분이에요.

예시 코딩 에이전트

deepagents-acp 패키지에는 파일시스템과 셸을 갖춘 예시 코딩 에이전트가 들어 있어서, 별도 설정 없이 바로 실행해 볼 수 있어요.

클라이언트 (Clients)

딥 에이전트는 ACP 에이전트 서버를 실행할 수 있는 곳이라면 어디서든 동작해요. 대표적인 ACP 클라이언트는 다음과 같아요.

Zed

deepagents 리포에는 Zed에 등록할 수 있는 데모 ACP 엔트리포인트가 있어요. 다음 순서로 설정해 봅시다.

  1. deepagents 리포를 클론하고 의존성을 설치합니다.
git clone https://github.com/langchain-ai/deepagents.git
cd deepagents/libs/acp
uv sync --all-groups
chmod +x run_demo_agent.sh
  1. 데모 에이전트용 크레덴셜을 설정합니다.
cp .env.example .env

그리고 .env에 ANTHROPIC_API_KEY를 설정해요.

  1. Zed의 settings.json에 ACP 에이전트 서버 커맨드를 설정합니다.
{
  "agent_servers": {
    "DeepAgents": {
      "type": "custom",
      "command": "/your/absolute/path/to/deepagents/libs/acp/run_demo_agent.sh"
    }
  }
}
  1. Zed의 Agents 패널을 열고 Deep Agents 스레드를 시작합니다.

Toad

ACP 에이전트 서버를 로컬 개발 도구로 실행하고 싶다면 Toad로 프로세스를 관리할 수 있어요.

uv tool install -U batrachian-toad
toad acp "python path/to/your_server.py" .
# or toad acp "uv run python path/to/your_server.py" .

프로토콜 상세와 에디터 지원은 업스트림 ACP 문서를 참고하세요.

더 알아보기 (Learn more)