Tesseract에 MCP 커넥터(MCP 서버)를 추가하는 방법

Tesseract는 stdio, HTTP, SSE를 통한 모든 MCP 서버와 공식 MCP 레지스트리의 서버를 지원해요. 설정 → 확장 프로그램 → 커넥터에서 주소, 실행 명령어 또는 JSON 설정으로 한 번만 추가하면 돼요. 그러면 Tesseract의 14개 에이전트 프레임워크 모두에서 서버의 도구를 사용할 수 있어요.

Tesseract 0.12.5 기준으로 확인했어요.

Tesseract에 MCP 서버를 추가하려면 어떻게 하나요?

설정 → 확장 프로그램 → 커넥터를 열고, 세 가지 형식 중 하나로 서버 정보를 입력하세요. 추가하기 전에 Tesseract가 내용을 보여줘요.

  1. 설정 → 확장 프로그램을 열고 커넥터 탭을 선택하세요.
  2. 맨 위의 입력란에 다음 중 하나를 붙여 넣고 추가를 누르세요.
    • 주소: 웹에서 실행되는 서버의 경우 https://mcp.example.com/mcp 같은 http(s) 링크를 입력하세요.
    • 명령어: npx -y @acme/notes-mcp처럼 컴퓨터에서 stdio를 통해 실행되는 서버의 경우 명령어를 입력하세요.
    • JSON 설정: 명령어, 인수 및 환경.
  3. Tesseract에 표시된 내용을 확인하세요. 명령어를 입력한 경우 실행할 전체 명령어가 표시되며, 허용하기 전에는 아무것도 실행되지 않아요.
  4. 아래쪽 버튼을 눌러 추가하세요. 명령어는 허용 및 추가, 주소는 커넥터 추가를 누르면 돼요. 버튼을 누르기 전에는 아무것도 추가되지 않아요.

서버 README에 있는 것처럼 JSON 설정을 붙여 넣을 수 있나요?

네. Tesseract는 url 또는 command가 포함된 단일 서버 설정이나 mcpServers 아래의 전체 블록을 읽어요. servers, mcp 또는 mcp_servers 아래에 있는 서버 설정도 찾아내요.

예를 들어, 컴퓨터에서 실행되는 서버는 다음과 같아요.

{ "mcpServers": { "notes": { "command": "npx", "args": ["-y", "@acme/notes-mcp"] } } }

설정에 여러 서버가 포함되어 있으면 Tesseract가 각각 표시하고, 추가할 서버를 선택할 수 있어요.

공식 MCP 레지스트리에서 서버를 추가하려면 어떻게 하나요?

커넥터 탭의 입력란 옆에 있는 디렉터리 찾아보기를 누른 다음, 원하는 서버를 추가하세요.

  1. 설정 → 확장 프로그램 → 커넥터를 여세요.
  2. 디렉터리 찾아보기를 누르세요. 공식 MCP 레지스트리에 있는 서버 목록이 표시되며, 이름으로 검색할 수도 있어요.
  3. 원하는 항목에서 추가를 누르세요. 주소나 명령어를 붙여 넣을 때와 같은 단계가 표시되며, 사용자가 승인하기 전에는 아무것도 추가되지 않아요.

Claude Code, Codex, Gemini CLI, OpenCode에서도 사용할 수 있나요?

네. 이 사이트의 모든 프레임워크 페이지에서 지원 항목으로 "Tesseract 도구 및 MCP 서버"를 확인할 수 있어요. 14개 프레임워크 모두 지원하며, Claude Code, OpenAI Codex, OpenCode, Gemini CLI, Antigravity CLI, Kimi Code, Qwen Code, MiniMax Code, CodeBuddy, Grok Build, Cursor, Hermes Agent, OpenClaw, NanoClaw가 포함돼요. 커넥터는 Tesseract에서 한 번만 추가하면 되며, 프레임워크마다 추가할 필요가 없어요. 대화마다 프레임워크를 선택하므로 서로 다른 대화에서 각기 다른 프레임워크를 사용할 수 있어요.

커넥터에 "Tesseract에 추가" 버튼을 만들려면 어떻게 하나요?

무료 제작 도구 tesseract.dev/connect/를 사용하세요. README에 넣을 Markdown 배지와 일반 링크를 만들 수 있어요.

  1. tesseract.dev/connect/를 여세요.
  2. 커넥터 이름을 입력하세요.
  3. 서버 주소 또는 JSON 형식의 설정을 붙여 넣으세요.
  4. Markdown을 README에 붙여 넣거나 링크를 복사하세요.

배지 링크는 앱으로 바로 연결되지 않고 tesseract.dev 페이지로 연결돼요. GitHub에서 http(s)가 아닌 링크를 제거하기 때문이에요. 주소는 최대 2,048자까지 사용할 수 있어요. 설정은 최대 20,000자의 JSON 객체 하나여야 해요. 설정은 인코딩(base64url)만 거쳐 링크 자체에 기록되므로 실제 키나 토큰은 넣지 마세요.

버튼을 클릭하면 어떻게 되나요?

먼저 tesseract.dev에서 커넥터를 확인하게 되고, 아무것도 자동으로 열리지 않아요.

  1. 페이지에는 커넥터가 무엇인지 표시돼요. 연결되는 웹 주소나 실행되는 명령이 전문 그대로 나와요.
  2. Tesseract에서 열기와 앱이 없는 사람을 위한 Tesseract 받기가 표시돼요.
  3. Tesseract에서 열기를 누르면 설정 → 확장 프로그램 → 커넥터가 열리고, 커넥터가 입력란에 미리 입력된 상태로 표시돼요. "링크에서 가져왔어요"라는 표시도 함께 나와요.
  4. 무언가 추가되기 전에 Tesseract에서 다시 내용을 보여 주고, 실행하기 전에도 확인을 요청해요.

url= 또는 config=을 읽을 수 없는 링크에는 "이 링크에는 커넥터 이름이 없습니다"라고 표시돼요.

Claude나 ChatGPT에서 Tesseract를 사용하는 것과 같은 건가요?

아니요. 이 가이드는 다른 MCP 서버를 Tesseract에 연결하는 방법이에요. Claude와 ChatGPT에서 Tesseract 사용하기는 반대로, 주소 하나로 Tesseract를 채팅 앱에 추가하는 방법이에요.

질문

Tesseract에서 어떤 MCP 서버든 사용할 수 있나요?

stdio, HTTP 또는 SSE를 사용하는 MCP 서버라면 모두 연결할 수 있어요.

Claude Code와 Codex에 서버를 각각 따로 설정해야 하나요?

아니요. 설정 → 확장 프로그램 → 커넥터에서 한 번만 추가하면 Tesseract의 모든 프레임워크에서 사용할 수 있어요.

README의 mcpServers JSON을 붙여 넣을 수 있나요?

네. Tesseract는 서버 하나의 설정이나 전체 mcpServers 블록을 읽을 수 있어요.

공식 MCP 레지스트리의 서버는 어디에서 찾을 수 있나요?

설정 → 확장 프로그램 → 커넥터에서 디렉터리 둘러보기 아래에 있어요.

"Tesseract에 추가" 링크를 누르면 커넥터가 자동으로 추가되나요?

아니요. 무언가 추가되기 전에 Tesseract에서 다시 내용을 보여 주고, 실행하기 전에도 확인을 요청해요.

가이드 더 보기