Claude Code에 Textumi 연결하기

시작하기 전에

• MCP, 개인 또는 프로페셔널 요금제의 Textumi 계정. 어떤 계정이든 연결할 수 있지만, 요금제에 어시스턴트를 통한 작업이 포함되기 전까지는 확인과 다시 쓰기가 거절돼요.
• 설치하고 로그인까지 마친 Claude Code.
• Textumi 서버 주소:

https://textumi.com/mcp

로그인으로 연결하기

1. 터미널에서 이 명령을 실행하세요:

claude mcp add --transport http --scope user textumi https://textumi.com/mcp

1. Claude Code를 시작하고 /mcp를 입력하세요. textumi를 선택한 뒤 인증을 선택하세요.
2. 브라우저에서 Textumi가 열려요. 필요하면 로그인하고, ‘AI 애플리케이션 연결’ 페이지에 내 계정이 표시되는지 확인한 뒤 ‘연결’을 선택하세요.
3. 터미널로 돌아오세요. 이제 /mcp에 textumi가 연결됨으로 표시되고 도구 목록도 함께 보여요.

액세스 토큰으로 연결하기

1. Textumi에 로그인하고 ‘계정’ > ‘AI 에이전트’를 여세요.
2. 나중에 알아볼 수 있는 이름을 토큰에 붙이고 ‘액세스 토큰 만들기’를 선택하세요. 페이지에 토큰이 단 한 번 표시되며, 토큰이 미리 들어간 아래 명령도 함께 보여요.
3. 터미널에서 명령을 실행하세요:

claude mcp add --transport http --scope user textumi https://textumi.com/mcp --header "Authorization: Bearer YOUR_TOKEN"

설정이 저장되는 위치

토큰을 공유하지 않고 팀과 설정을 공유하려면 프로젝트의 .mcp.json에 아래 내용을 넣으세요. 각자 자신의 토큰을 TEXTUMI_TOKEN 환경 변수에 보관하면 돼요:

{
  "mcpServers": {
    "textumi": {
      "type": "http",
      "url": "https://textumi.com/mcp",
      "headers": { "Authorization": "Bearer ${TEXTUMI_TOKEN}" }
    }
  }
}

연결 확인하고 사용하기

claude mcp list를 실행하세요. Textumi가 ‘Connected’로 표시되어야 해요. ‘Needs authentication’으로 표시되면 Claude Code에서 /mcp를 열고 로그인하세요. 토큰이 잘못됐거나 연결이 해제된 경우에는 401 오류가 표시돼요.

원하는 대로 요청하세요. 예를 들어 “Textumi로 이 텍스트 확인해 줘”, “Textumi로 이 텍스트 휴머나이즈해 줘”, “Textumi 단어가 얼마나 남았어?”처럼 말하면 돼요. Claude Code가 직접 Textumi 도구를 호출하고 결과를 보여 줘요.

같은 계정으로 웹에서 Claude도 쓰고 있다면, 그곳에서 추가한 Textumi 커넥터가 Claude Code에도 나타나요.

Textumi 연결 해제하기

추가할 때와 같은 범위를 지정해 이 명령으로 설정을 삭제하세요:

claude mcp remove --scope user textumi

Textumi에서는 ‘계정’ > ‘AI 에이전트’를 여세요. 모든 연결이 ‘연결’ 아래에 ‘연결 해제’ 버튼과 함께 표시돼요. Textumi 비밀번호를 바꾸면 모든 애플리케이션의 연결이 한 번에 해제돼요.