콘텐츠로 이동
도움말

MCP로 다른 도구와 연결하기

MCP는 AI와 도구를 연결하는 규약입니다. 온유오피스에서는 아래 두 방향의 연결이 있으므로 먼저 하려는 일을 고르세요.

하려는 일 연결 방향 시작 위치
AI 창에서 외부 검색·자료 도구 사용 온유오피스 → 외부 MCP 서버 설정 → 연동 → MCP 서버
코딩 도구에서 문서 엔진 사용 외부 클라이언트 → 온유오피스 설정 → 연동의 앱 MCP 안내

먼저 위 표에서 연결 방향을 고른 뒤 필요한 절차로 이동하세요.

서버 운영자가 제공한 공식 연결 안내를 준비하세요. 주소로 연결하는 서버라면 URL과 필요한 인증 방식, 내 PC에서 실행하는 서버라면 프로그램·인자·환경 변수 안내가 필요합니다. 연결 정보는 이 웹사이트에 입력하지 않고 앱 설정에서 관리합니다.

  1. 설정 → 연동 → MCP 서버 → 서버 더하기를 엽니다.
  2. 서버 안내의 설정을 사용할 때는 설정 글 붙여넣기에 넣고 읽기를 누릅니다. 주소를 알고 있다면 직접 넣기를 고릅니다.
  3. 채워진 이름·주소 또는 실행 명령을 확인합니다. ${변수}처럼 표시된 값은 실제 인증 정보가 아니므로 필요한 칸을 앱에서 채우세요.
  4. 안내를 읽고 등록합니다. 내 PC 서버라면 프로그램·인자·환경 변수를 확인하고 실행 여부를 판단합니다.

다른 스킬에서 mcp__서버이름__도구이름을 지정했다면 등록하는 서버 이름도 맞아야 합니다. 이름만 같다고 같은 서버인 것은 아니므로 주소와 출처도 확인하세요.

표시·상황 다음 조치
확인 전 연결 확인으로 도구 목록을 받아오기
로그인 필요 브라우저로 로그인에서 해당 서버의 인증 완료
실행 허락 필요 내 PC에서 실행할 명령을 읽고 허용 여부 결정
연결 못 함 자세히에서 이유를 확인하고 주소·프로그램·인증 점검
연결되어 도구가 보임 필요한 도구의 허락을 확인하고 작은 요청부터 시도

서버 등록만으로 정상 연결됐다고 판단하지 마세요. 설정에 실제 도구 목록이 보이는지 확인해야 합니다.

도구별로 항상 허용, 물어보고 사용, 사용 안 함을 고를 수 있습니다. 처음 사용하는 도구는 물어보고 사용으로 두고 입력 내용을 확인하는 것이 좋습니다.

AI 창의 연결한 서버에서 대화에 사용할 서버를 확인하세요. 연습 자료처럼 공유해도 되는 작은 내용으로 요청하고, 어떤 서버의 어떤 도구가 호출됐는지 확인합니다. 사용 허락 카드가 나오면 실제 보낼 내용과 변경 가능성을 읽고 결정하세요.

이 문서는 특정 외부 서버를 지정하거나 연결 성공을 보장하지 않습니다. 서버마다 계정·요금·제공 도구가 다릅니다.

대화에서만 끄는 것과 설정에서 서버를 끄거나 지우는 것은 다릅니다. 그 대화에서 잠시 제외하려면 연결한 서버를 사용하세요. 설정이나 도구 설명이 바뀌어 확인 필요가 나타나면 변경 내용을 읽고 다시 판단합니다.

도구 입력에는 문서 내용이 포함될 수 있고, 도구 결과는 사용 중인 AI 제공자에게 전달될 수 있습니다.

받은 내용 지키기를 켠 서버의 자료가 대화에 들어오면, 일반 AI 창에서는 다른 외부 전송 도구가 제한될 수 있습니다. 다른 도구가 갑자기 보이지 않을 때 이 설정과 대화 상태를 확인하세요. 에이전트 창에는 같은 보호가 적용되지 않으므로 시작 안내를 읽어야 합니다.

또한 설정 → AI 미디어 및 검색 → AI가 인터넷 도구 쓰기를 끄면 MCP 도구도 빠집니다. 연결 오류와 이 설정으로 인한 비활성화를 구분하세요.

코딩 도구에서 온유오피스 사용하기

섹션 제목: “코딩 도구에서 온유오피스 사용하기”

앱의 설정 → 연동에 표시된 MCP 연결 안내를 기준으로 사용 중인 클라이언트에 등록합니다. 프로그램을 실행하는 방식과 실행 중인 앱의 로컬 서버에 연결하는 방식을 구분하세요.

  1. 사용할 앱 버전과 클라이언트를 확인합니다.
  2. 앱에 표시된 명령·경로·서버 주소·인증 조건을 확인합니다.
  3. 클라이언트에 등록한 뒤 제공되는 도구 목록을 확인합니다.
  4. 실제 업무 파일 대신 연습 파일의 읽기 작업부터 확인합니다.

운영체제별 설치 경로와 클라이언트 설정이 다르므로, 확인하지 않은 명령을 제품 이름만 바꿔 실행하지 마세요. 현재 이 사이트는 설치·실행을 검증한 클라이언트별 명령 예제를 제공하지 않습니다.

관련 안내: 스킬 · AI와 데이터 · 문제 해결